summaryrefslogtreecommitdiffstats
path: root/net/flip/flip_protocol.h
diff options
context:
space:
mode:
authormbelshe@google.com <mbelshe@google.com@0039d316-1c4b-4281-b951-d872f2087c98>2009-09-17 21:03:56 +0000
committermbelshe@google.com <mbelshe@google.com@0039d316-1c4b-4281-b951-d872f2087c98>2009-09-17 21:03:56 +0000
commit1cd87e7d86da069a9028f24307c93e285848e0e7 (patch)
tree77e320ea74e0e81da7d6cb2060929ca3ffdfa16c /net/flip/flip_protocol.h
parentc0d297956354b9c74fdcfb717efb272a772f4315 (diff)
downloadchromium_src-1cd87e7d86da069a9028f24307c93e285848e0e7.zip
chromium_src-1cd87e7d86da069a9028f24307c93e285848e0e7.tar.gz
chromium_src-1cd87e7d86da069a9028f24307c93e285848e0e7.tar.bz2
This is not production code; landing some experimental network code.
BUG=none TEST=flip_session_unittest.cc flip_network_transaction_unittest.cc flip_framer_test.cc Review URL: http://codereview.chromium.org/200084 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@26484 0039d316-1c4b-4281-b951-d872f2087c98
Diffstat (limited to 'net/flip/flip_protocol.h')
-rw-r--r--net/flip/flip_protocol.h203
1 files changed, 203 insertions, 0 deletions
diff --git a/net/flip/flip_protocol.h b/net/flip/flip_protocol.h
new file mode 100644
index 0000000..93c8a5a
--- /dev/null
+++ b/net/flip/flip_protocol.h
@@ -0,0 +1,203 @@
+// Copyright (c) 2009 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// This file contains some protocol structures for use with Flip.
+
+#ifndef NET_FLIP_FLIP_PROTOCOL_H_
+#define NET_FLIP_FLIP_PROTOCOL_H_
+
+#ifdef WIN32
+#include <winsock2.h>
+#else
+#include <arpa/inet.h>
+#endif
+#include "base/basictypes.h"
+#include "base/logging.h"
+#include "flip_bitmasks.h" // cross-google3 directory naming.
+
+
+// Stream Frame Format
+// +-------------------------------+
+// |0| Stream-ID (31bits) |
+// +-------------------------------+
+// |flags (16)| Length (16bits) |
+// +-------------------------------+
+// | Data |
+// +-------------------------------+
+//
+
+// Control Frame Format
+// +-------------------------------+
+// |1| Version(15bits)|Type(16bits)|
+// +-------------------------------+
+// | Length (32bits) |
+// +-------------------------------+
+// | Data |
+// +-------------------------------+
+//
+
+
+// Control Frame: SYN_STREAM
+// +----------------------------------+
+// |1|000000000000001|0000000000000001|
+// +----------------------------------+
+// | Length (32bits) | >= 8
+// +----------------------------------+
+// |X| Stream-ID(31bits) |
+// +----------------------------------+
+// |Pri| unused | Length (16bits)|
+// +----------------------------------+
+//
+// Control Frame: SYN_REPLY
+// +----------------------------------+
+// |1|000000000000001|0000000000000010|
+// +----------------------------------+
+// | Length (32bits) | >= 8
+// +----------------------------------+
+// |X| Stream-ID(31bits) |
+// +----------------------------------+
+// | unused (16 bits)| Length (16bits)|
+// +----------------------------------+
+//
+// Control Frame: FIN_STREAM
+// +----------------------------------+
+// |1|000000000000001|0000000000000011|
+// +----------------------------------+
+// | Length (32bits) | >= 4
+// +----------------------------------+
+// |X| Stream-ID(31bits) |
+// +----------------------------------+
+// | Status (32 bits) |
+// +----------------------------------+
+//
+// Control Frame: SetMaxStreams
+// +----------------------------------+
+// |1|000000000000001|0000000000000100|
+// +----------------------------------+
+// | Length (32bits) | >= 4
+// +----------------------------------+
+// |X| Stream-ID(31bits) |
+// +----------------------------------+
+
+// TODO(fenix): add ChangePriority support.
+
+namespace flip {
+
+// Note: all protocol data structures are on-the-wire format. That means that
+// data is stored in network-normalized order. Readers must use the
+// accessors provided or call ntohX() functions.
+
+// Types of Flip Control Frames.
+typedef enum {
+ SYN_STREAM = 1,
+ SYN_REPLY,
+ FIN_STREAM,
+ NOOP
+} FlipControlType;
+
+// Flags on data packets
+typedef enum {
+ DATA_FLAG_COMPRESSED = 1
+} FlipDataFlags;
+
+// A FLIP stream id is a 31 bit entity.
+typedef uint32 FlipStreamId;
+
+// FLIP Priorities. (there are only 2 bits)
+#define FLIP_PRIORITY_LOWEST 3
+#define FLIP_PRIORITY_HIGHEST 0
+
+// All Flip Frame types derive from the FlipFrame struct.
+typedef struct {
+ uint32 length() const { return ntohs(data_.length_); }
+ void set_length(uint16 length) { data_.length_ = htons(length); }
+ bool is_control_frame() const {
+ return (ntohs(control_.version_) & kControlFlagMask) == kControlFlagMask;
+ }
+
+ protected:
+ union {
+ struct {
+ uint16 version_;
+ uint16 type_;
+ uint32 length_;
+ } control_;
+ struct {
+ FlipStreamId stream_id_;
+ uint16 flags_;
+ uint16 length_;
+ } data_;
+ };
+} FlipFrame;
+
+// A Data Frame.
+typedef struct : public FlipFrame {
+ FlipStreamId stream_id() const {
+ return ntohl(data_.stream_id_) & kStreamIdMask;
+ }
+ void set_stream_id(FlipStreamId id) { data_.stream_id_ = htonl(id); }
+ uint16 flags() const { return ntohs(data_.flags_); }
+ void set_flags(uint16 flags) { data_.flags_ = htons(flags); }
+} FlipDataFrame;
+
+// A Control Frame.
+typedef struct : public FlipFrame {
+ uint16 version() const {
+ const int kVersionMask = 0x7fff;
+ return ntohs(control_.version_) & kVersionMask;
+ }
+ FlipControlType type() const {
+ uint16 type = ntohs(control_.type_);
+ DCHECK(type >= SYN_STREAM && type <= NOOP);
+ return static_cast<FlipControlType>(type);
+ }
+ FlipStreamId stream_id() const { return ntohl(stream_id_) & kStreamIdMask; }
+
+ private:
+ FlipStreamId stream_id_;
+} FlipControlFrame;
+
+// A SYN_STREAM frame.
+typedef struct FlipSynStreamControlFrame : public FlipControlFrame {
+ uint8 priority() const { return (priority_ & kPriorityMask) >> 6; }
+ int header_block_len() const { return length() - kHeaderBlockOffset; }
+ const char* header_block() const {
+ return reinterpret_cast<const char*>(this) +
+ sizeof(FlipFrame) + kHeaderBlockOffset;
+ }
+ private:
+ // Offset from the end of the FlipControlFrame to the FlipHeaderBlock.
+ static const int kHeaderBlockOffset = 6;
+ uint8 priority_;
+ uint8 unused_;
+ // Variable FlipHeaderBlock here.
+} FlipSynStreamControlFrame;
+
+// A SYN_REPLY frame.
+typedef struct FlipSynReplyControlFrame : public FlipControlFrame {
+ int header_block_len() const { return length() - kHeaderBlockOffset; }
+ const char* header_block() const {
+ return reinterpret_cast<const char*>(this) +
+ sizeof(FlipFrame) + kHeaderBlockOffset;
+ }
+
+ private:
+ // Offset from the end of the FlipControlFrame to the FlipHeaderBlock.
+ static const int kHeaderBlockOffset = 6;
+ uint16 unused_;
+ // Variable FlipHeaderBlock here.
+} FlipSynReplyControlFrame;
+
+// A FIN_STREAM frame.
+typedef struct FlipFinStreamControlFrame : public FlipControlFrame {
+ uint32 status() const { return ntohl(status_); }
+ void set_status(int id) { status_ = htonl(id); }
+ private:
+ uint32 status_;
+} FlipFinStreamControlFrame;
+
+} // namespace flip
+
+#endif // NET_FLIP_FLIP_PROTOCOL_H_
+