quic_protocol.h revision 0f1bc08d4cfcc34181b0b5cbf065c40f687bf740
15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef NET_QUIC_QUIC_PROTOCOL_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define NET_QUIC_QUIC_PROTOCOL_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <stddef.h> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <limits> 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <map> 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <ostream> 121320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci#include <set> 132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include <string> 14f8ee788a64d60abd8f2d742a5fdedde054ecd910Torne (Richard Coles)#include <utility> 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 16ca12bfac764ba476d6cd062bf1dde12cc64c3f40Ben Murdoch 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 185d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#include "base/containers/hash_tables.h" 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/logging.h" 202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "base/strings/string_piece.h" 2158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles)#include "net/base/int128.h" 227dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch#include "net/base/net_export.h" 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/quic/quic_bandwidth.h" 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/quic/quic_time.h" 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace net { 27116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)using ::operator<<; 2903b57e008b61dfcb1fbad3aea950ae0e001748b0Torne (Richard Coles) 306e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)class QuicAckNotifier; 316e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)class QuicPacket; 3203b57e008b61dfcb1fbad3aea950ae0e001748b0Torne (Richard Coles)struct QuicPacketHeader; 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicGuid; 357dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdochtypedef uint32 QuicStreamId; 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicStreamOffset; 372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef uint64 QuicPacketSequenceNumber; 38f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef QuicPacketSequenceNumber QuicFecGroupNumber; 39c5cede9ae108bb15f6b7a8aea21c7e1fefa2834cBen Murdochtypedef uint64 QuicPublicResetNonceProof; 40a02191e04bc25c4935f804f2c080ae28663d096dBen Murdochtypedef uint8 QuicPacketEntropyHash; 413551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)typedef uint32 QuicHeaderId; 42c5cede9ae108bb15f6b7a8aea21c7e1fefa2834cBen Murdoch// QuicTag is the type of a tag in the wire protocol. 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint32 QuicTag; 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef std::vector<QuicTag> QuicTagVector; 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint32 QuicPriority; 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 475d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// TODO(rch): Consider Quic specific names for these constants. 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Default and initial maximum size in bytes of a QUIC packet. 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicByteCount kDefaultMaxPacketSize = 1200; 506e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)// The maximum packet size of any QUIC packet, based on ethernet's max size, 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// minus the IP and UDP headers. 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicByteCount kMaxPacketSize = 1472; 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Maximum size of the initial congestion window in packets. 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kDefaultInitialWindow = 10; 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kMaxInitialWindow = 100; 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Don't allow a client to suggest an RTT longer than 15 seconds. 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const uint32 kMaxInitialRoundTripTimeUs = 15 * kNumMicrosPerSecond; 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Maximum number of open streams per connection. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kDefaultMaxStreamsPerConnection = 100; 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Number of bytes reserved for public flags in the packet header. 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kPublicFlagsSize = 1; 667dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// Number of bytes reserved for version number in the packet header. 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kQuicVersionSize = 4; 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Number of bytes reserved for private flags in the packet header. 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kPrivateFlagsSize = 1; 702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for FEC group in the packet header. 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kFecGroupSize = 1; 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Number of bytes reserved for the nonce proof in public reset packet. 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kPublicResetNonceSize = 8; 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Signifies that the QuicPacket will contain version of the protocol. 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const bool kIncludeVersion = true; 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Index of the first byte in a QUIC packet which is used in hash calculation. 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kStartOfHashData = 0; 80a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Limit on the delta between stream IDs. 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicStreamId kMaxStreamIdDelta = 100; 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Limit on the delta between header IDs. 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicHeaderId kMaxHeaderIdDelta = 100; 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Reserved ID for the crypto stream. 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(rch): ensure that this is not usable by any other streams. 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicStreamId kCryptoStreamId = 1; 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This is the default network timeout a for connection till the crypto 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// handshake succeeds and the negotiated timeout from the handshake is received. 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int64 kDefaultInitialTimeoutSecs = 120; // 2 mins. 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int64 kDefaultTimeoutSecs = 60 * 10; // 10 minutes. 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int64 kDefaultMaxTimeForCryptoHandshakeSecs = 5; // 5 secs. 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// We define an unsigned 16-bit floating point value, inspired by IEEE floats 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// (http://en.wikipedia.org/wiki/Half_precision_floating-point_format), 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// with 5-bit exponent (bias 1), 11-bit mantissa (effective 12 with hidden 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// bit) and denormals, but without signs, transfinites or fractions. Wire format 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 16 bits (little-endian byte order) are split into exponent (high 5) and 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// mantissa (low 11) and decoded as: 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// uint64 value; 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// if (exponent == 0) value = mantissa; 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// else value = (mantissa | 1 << 11) << (exponent - 1) 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int kUFloat16ExponentBits = 5; 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int kUFloat16MaxExponent = (1 << kUFloat16ExponentBits) - 2; // 30 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int kUFloat16MantissaBits = 16 - kUFloat16ExponentBits; // 11 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int kUFloat16MantissaEffectiveBits = kUFloat16MantissaBits + 1; // 12 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const uint64 kUFloat16MaxValue = // 0x3FFC0000000 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ((GG_UINT64_C(1) << kUFloat16MantissaEffectiveBits) - 1) << 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kUFloat16MaxExponent; 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum TransmissionType { 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NOT_RETRANSMISSION, 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NACK_RETRANSMISSION, 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RTO_RETRANSMISSION, 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum HasRetransmittableData { 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NO_RETRANSMITTABLE_DATA, 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HAS_RETRANSMITTABLE_DATA, 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum IsHandshake { 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NOT_HANDSHAKE, 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) IS_HANDSHAKE 1272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicFrameType { 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PADDING_FRAME = 0, 1312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) RST_STREAM_FRAME, 132a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) CONNECTION_CLOSE_FRAME, 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) GOAWAY_FRAME, 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) STREAM_FRAME, 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ACK_FRAME, 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CONGESTION_FEEDBACK_FRAME, 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NUM_FRAME_TYPES 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 139a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 140d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)enum QuicGuidLength { 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_0BYTE_GUID = 0, 1422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_1BYTE_GUID = 1, 143a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) PACKET_4BYTE_GUID = 4, 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_8BYTE_GUID = 8 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum InFecGroup { 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NOT_IN_FEC_GROUP, 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) IN_FEC_GROUP, 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1527dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdochenum QuicSequenceNumberLength { 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_1BYTE_SEQUENCE_NUMBER = 1, 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_2BYTE_SEQUENCE_NUMBER = 2, 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_4BYTE_SEQUENCE_NUMBER = 4, 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_6BYTE_SEQUENCE_NUMBER = 6 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Used to indicate a QuicSequenceNumberLength using two flag bits. 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicSequenceNumberLengthFlags { 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_FLAGS_1BYTE_SEQUENCE = 0, // 00 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_FLAGS_2BYTE_SEQUENCE = 1, // 01 1632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_FLAGS_4BYTE_SEQUENCE = 1 << 1, // 10 1642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_FLAGS_6BYTE_SEQUENCE = 1 << 1 | 1, // 11 1652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 1662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 1672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// The public flags are specified in one byte. 1682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicPacketPublicFlags { 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_PUBLIC_FLAGS_NONE = 0, 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Bit 0: Does the packet header contains version info? 1722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_PUBLIC_FLAGS_VERSION = 1 << 0, 1732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 174a02191e04bc25c4935f804f2c080ae28663d096dBen Murdoch // Bit 1: Is this packet a public reset packet? 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_PUBLIC_FLAGS_RST = 1 << 1, 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Bits 2 and 3 specify the length of the GUID as follows: 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ----00--: 0 bytes 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ----01--: 1 byte 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ----10--: 4 bytes 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ----11--: 8 bytes 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_PUBLIC_FLAGS_0BYTE_GUID = 0, 1837dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_1BYTE_GUID = 1 << 2, 1847dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_4BYTE_GUID = 1 << 3, 1857dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_8BYTE_GUID = 1 << 3 | 1 << 2, 1867dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 1877dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bits 4 and 5 describe the packet sequence number length as follows: 1887dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --00----: 1 byte 189a3f7b4e666c476898878fa745f637129375cd889Ben Murdoch // --01----: 2 bytes 1907dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --10----: 4 bytes 19158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // --11----: 6 bytes 1927dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_1BYTE_SEQUENCE = PACKET_FLAGS_1BYTE_SEQUENCE << 4, 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PACKET_PUBLIC_FLAGS_2BYTE_SEQUENCE = PACKET_FLAGS_2BYTE_SEQUENCE << 4, 1947dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_4BYTE_SEQUENCE = PACKET_FLAGS_4BYTE_SEQUENCE << 4, 1957dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_6BYTE_SEQUENCE = PACKET_FLAGS_6BYTE_SEQUENCE << 4, 1967dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 1977dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // All bits set (bits 6 and 7 are not currently used): 00111111 1987dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_MAX = (1 << 6) - 1 1997dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch}; 2007dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2017dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// The private flags are specified in one byte. 2027dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdochenum QuicPacketPrivateFlags { 2037dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_NONE = 0, 2047dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 205a3f7b4e666c476898878fa745f637129375cd889Ben Murdoch // Bit 0: Does this packet contain an entropy bit? 2067dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_ENTROPY = 1 << 0, 20758537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 2087dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 1: Payload is part of an FEC group? 2097dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_FEC_GROUP = 1 << 1, 2107dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2117dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 2: Payload is FEC as opposed to frames? 2127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_FEC = 1 << 2, 2137dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2147dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // All bits set (bits 3-7 are not currently used): 00000111 2157dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_MAX = (1 << 3) - 1 2165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// The available versions of QUIC. Guaranteed that the integer value of the enum 2192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// will match the version number. 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// When adding a new version to this enum you should add it to 2212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// kSupportedQuicVersions (if appropriate), and also add a new case to the 2221320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci// helper methods QuicVersionToQuicTag, QuicTagToQuicVersion, and 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// QuicVersionToString. 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicVersion { 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Special case to indicate unknown/unsupported QUIC version. 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_VERSION_UNSUPPORTED = 0, 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_VERSION_10 = 10, 2292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QUIC_VERSION_11 = 11, 2302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QUIC_VERSION_12 = 12, // Current version. 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This vector contains QUIC versions which we currently support. 2342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// This should be ordered such that the highest supported version is the first 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// element, with subsequent elements in descending order (versions can be 2362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// skipped as necessary). 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static const QuicVersion kSupportedQuicVersions[] = 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) {QUIC_VERSION_11}; 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef std::vector<QuicVersion> QuicVersionVector; 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns a vector of QUIC versions in kSupportedQuicVersions. 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE QuicVersionVector QuicSupportedVersions(); 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// QuicTag is written to and read from the wire, but we prefer to use 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the more readable QuicVersion at other levels. 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Helper function which translates from a QuicVersion to a QuicTag. Returns 0 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// if QuicVersion is unsupported. 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE QuicTag QuicVersionToQuicTag(const QuicVersion version); 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns appropriate QuicVersion from a QuicTag. 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns QUIC_VERSION_UNSUPPORTED if version_tag cannot be understood. 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE QuicVersion QuicTagToQuicVersion(const QuicTag version_tag); 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Helper function which translates from a QuicVersion to a string. 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns strings corresponding to enum names (e.g. QUIC_VERSION_6). 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE std::string QuicVersionToString(const QuicVersion version); 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns comma separated list of string representations of QuicVersion enum 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// values in the supplied |versions| vector. 2612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)NET_EXPORT_PRIVATE std::string QuicVersionVectorToString( 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QuicVersionVector& versions); 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Version and Crypto tags are written to the wire with a big-endian 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// representation of the name of the tag. For example 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the client hello tag (CHLO) will be written as the 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// following 4 bytes: 'C' 'H' 'L' 'O'. Since it is 2685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// stored in memory as a little endian uint32, we need 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// to reverse the order of the bytes. 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 271a3f7b4e666c476898878fa745f637129375cd889Ben Murdoch// MakeQuicTag returns a value given the four bytes. For example: 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// MakeQuicTag('C', 'H', 'L', 'O'); 2735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE QuicTag MakeQuicTag(char a, char b, char c, char d); 2745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Size in bytes of the data or fec packet header. 2765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPacketHeaderSize(QuicPacketHeader header); 2775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPacketHeaderSize( 2795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuidLength guid_length, 2802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool include_version, 2815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 2825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) InFecGroup is_in_fec_group); 2835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2847dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// Size in bytes of the public reset packet. 2855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPublicResetPacketSize(); 2865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Index of the first byte in a QUIC packet of FEC protected data. 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetStartOfFecProtectedData( 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuidLength guid_length, 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool include_version, 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length); 2925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Index of the first byte in a QUIC packet of encrypted data. 2935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetStartOfEncryptedData( 2947dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QuicGuidLength guid_length, 2957dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch bool include_version, 2967dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QuicSequenceNumberLength sequence_number_length); 2977dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2987dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdochenum QuicRstStreamErrorCode { 2997dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_STREAM_NO_ERROR = 0, 300a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 3017dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // There was some error which halted stream processing. 3027dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_ERROR_PROCESSING_STREAM, 3037dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // We got two fin or reset offsets which did not match. 3047dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_MULTIPLE_TERMINATION_OFFSETS, 3057dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // We got bad payload and can not respond to it at the protocol level. 3067dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_BAD_APPLICATION_PAYLOAD, 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Stream closed due to connection error. No reset frame is sent when this 3087dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // happens. 3097dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_STREAM_CONNECTION_ERROR, 3107dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // GoAway frame sent. No more stream can be created. 3117dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_STREAM_PEER_GOING_AWAY, 3127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // The stream has been cancelled. 3137dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_STREAM_CANCELLED, 3147dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 3157dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // No error. Used as bound while iterating. 3167dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_STREAM_LAST_ERROR, 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// These values must remain stable as they are uploaded to UMA histograms. 3205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// To add a new error code, use the current value of QUIC_LAST_ERROR and 3215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// increment QUIC_LAST_ERROR. 3225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicErrorCode { 3235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_NO_ERROR = 0, 3245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Connection has reached an invalid state. 3265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INTERNAL_ERROR = 1, 3275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There were data frames after the a fin or reset. 3285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_STREAM_DATA_AFTER_TERMINATION = 2, 3295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Control frame is malformed. 3305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_PACKET_HEADER = 3, 3315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Frame data is malformed. 3325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_FRAME_DATA = 4, 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The packet contained no payload. 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_MISSING_PAYLOAD = 48, 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FEC data is malformed. 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_FEC_DATA = 5, 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // STREAM frame data is malformed. 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_STREAM_DATA = 46, 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // RST_STREAM frame data is malformed. 3405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_RST_STREAM_DATA = 6, 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // CONNECTION_CLOSE frame data is malformed. 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_CONNECTION_CLOSE_DATA = 7, 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // GOAWAY frame data is malformed. 3445d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_INVALID_GOAWAY_DATA = 8, 3455d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // ACK frame data is malformed. 3465d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_INVALID_ACK_DATA = 9, 3475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // CONGESTION_FEEDBACK frame data is malformed. 3485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_CONGESTION_FEEDBACK_DATA = 47, 3492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Version negotiation packet is malformed. 3502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QUIC_INVALID_VERSION_NEGOTIATION_PACKET = 10, 351868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) // Public RST packet is malformed. 352868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QUIC_INVALID_PUBLIC_RST_PACKET = 11, 3535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error decrypting. 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_DECRYPTION_FAILURE = 12, 3555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error encrypting. 3565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_ENCRYPTION_FAILURE = 13, 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The packet exceeded kMaxPacketSize. 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_PACKET_TOO_LARGE = 14, 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Data was sent for a stream which did not exist. 3605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_PACKET_FOR_NONEXISTENT_STREAM = 15, 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The peer is going away. May be a client or server. 3625d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_PEER_GOING_AWAY = 16, 3632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A stream ID was invalid. 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_STREAM_ID = 17, 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A priority was invalid. 3665d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_INVALID_PRIORITY = 49, 3675d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // Too many streams already open. 368c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_TOO_MANY_OPEN_STREAMS = 18, 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Received public reset for this connection. 3705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_PUBLIC_RESET = 19, 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Invalid protocol version. 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_VERSION = 20, 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Stream reset before headers decompressed. 3745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_STREAM_RST_BEFORE_HEADERS_DECOMPRESSED = 21, 3755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The Header ID for a stream was too far from the previous. 3765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_HEADER_ID = 22, 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Negotiable parameter received during handshake had invalid value. 3785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_NEGOTIATED_VALUE = 23, 379a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // There was an error decompressing data. 3805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_DECOMPRESSION_FAILURE = 24, 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We hit our prenegotiated (or default) timeout 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CONNECTION_TIMED_OUT = 25, 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error encountered migrating addresses 3845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_ERROR_MIGRATING_ADDRESS = 26, 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error while writing to the socket. 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_PACKET_WRITE_ERROR = 27, 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error while reading from the socket. 3885d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_PACKET_READ_ERROR = 51, 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We received a STREAM_FRAME with no data and no fin flag set. 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_STREAM_FRAME = 50, 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Crypto errors. 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Hanshake failed. 3965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_HANDSHAKE_FAILED = 28, 3975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Handshake message contained out of order tags. 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_TAGS_OUT_OF_ORDER = 29, 399868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) // Handshake message contained too many entries. 400868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QUIC_CRYPTO_TOO_MANY_ENTRIES = 30, 401868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) // Handshake message contained an invalid value length. 4025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_INVALID_VALUE_LENGTH = 31, 4035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received after the handshake was complete. 4045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_AFTER_HANDSHAKE_COMPLETE = 32, 4057dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // A crypto message was received with an illegal message tag. 4067dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_INVALID_CRYPTO_MESSAGE_TYPE = 33, 4075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received with an illegal parameter. 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_CRYPTO_MESSAGE_PARAMETER = 34, 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // An invalid channel id signature was supplied. 4105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_INVALID_CHANNEL_ID_SIGNATURE = 52, 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received with a mandatory parameter missing. 4127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QUIC_CRYPTO_MESSAGE_PARAMETER_NOT_FOUND = 35, 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received with a parameter that has no overlap 4145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // with the local parameter. 415a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_PARAMETER_NO_OVERLAP = 36, 4162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received that contained a parameter with too few 4175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // values. 4185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_INDEX_NOT_FOUND = 37, 4195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // An internal error occured in crypto processing. 4205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_INTERNAL_ERROR = 38, 4215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto handshake message specified an unsupported version. 4225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_VERSION_NOT_SUPPORTED = 39, 4235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was no intersection between the crypto primitives supported by the 4245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // peer and ourselves. 4255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_NO_SUPPORT = 40, 426f8ee788a64d60abd8f2d742a5fdedde054ecd910Torne (Richard Coles) // The server rejected our client hello messages too many times. 4275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_TOO_MANY_REJECTS = 41, 4285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The client rejected the server's certificate chain or signature. 4295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_PROOF_INVALID = 42, 4305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received with a duplicate tag. 4315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_DUPLICATE_TAG = 43, 4325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received with the wrong encryption level (i.e. it 4335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // should have been encrypted but was not.) 4345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_ENCRYPTION_LEVEL_INCORRECT = 44, 4355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The server config for a server has expired. 4365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_SERVER_CONFIG_EXPIRED = 45, 4375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We failed to setup the symmetric keys for a connection. 4385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_CRYPTO_SYMMETRIC_KEY_SETUP_FAILED = 53, 4395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // No error. Used as bound while iterating. 4415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_LAST_ERROR = 54, 4425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPacketPublicHeader { 4455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketPublicHeader(); 4465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicPacketPublicHeader(const QuicPacketPublicHeader& other); 4475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~QuicPacketPublicHeader(); 4485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Universal header. All QuicPacket headers will have a guid and public flags. 4505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuid guid; 4515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuidLength guid_length; 4525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool reset_flag; 4535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool version_flag; 4545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length; 4555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicVersionVector versions; 4565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Header for Data or FEC packets. 4595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPacketHeader { 4605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketHeader(); 4615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicPacketHeader(const QuicPacketPublicHeader& header); 4625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 4645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::ostream& os, const QuicPacketHeader& s); 4655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketPublicHeader public_header; 4675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fec_flag; 4685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool entropy_flag; 4695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketEntropyHash entropy_hash; 4705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber packet_sequence_number; 4715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) InFecGroup is_in_fec_group; 4725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecGroupNumber fec_group; 4735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 474c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 4755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPublicResetPacket { 4765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPublicResetPacket() {} 4775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicPublicResetPacket(const QuicPacketPublicHeader& header) 4785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : public_header(header) {} 4795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketPublicHeader public_header; 4805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber rejected_sequence_number; 4815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPublicResetNonceProof nonce_proof; 4825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicVersionNegotiationState { 4855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) START_NEGOTIATION = 0, 4865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Server-side this implies we've sent a version negotiation packet and are 4875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // waiting on the client to select a compatible version. Client-side this 4885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // implies we've gotten a version negotiation packet, are retransmitting the 4895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // initial packets with a supported version and are waiting for our first 4905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // packet from the server. 4915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NEGOTIATION_IN_PROGRESS, 4925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This indicates this endpoint has received a packet from the peer with a 4935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // version this endpoint supports. Version negotiation is complete, and the 4945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // version number will no longer be sent with future packets. 4955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NEGOTIATED_VERSION 4965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef QuicPacketPublicHeader QuicVersionNegotiationPacket; 4995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// A padding frame contains no payload. 5015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPaddingFrame { 5025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicStreamFrame { 5055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame(); 5065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame(QuicStreamId stream_id, 5075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fin, 5085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamOffset offset, 5095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece data); 5105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId stream_id; 5125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fin; 5135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamOffset offset; // Location of this data in the stream. 5145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece data; 5155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If this is set, then when this packet is ACKed the AckNotifier will be 5175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // informed. 5185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckNotifier* notifier; 5195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(ianswett): Re-evaluate the trade-offs of hash_set vs set when framing 5225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is finalized. 5235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef std::set<QuicPacketSequenceNumber> SequenceNumberSet; 5245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(pwestin): Add a way to enforce the max size of this map. 5255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef std::map<QuicPacketSequenceNumber, QuicTime> TimeMap; 5265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE ReceivedPacketInfo { 5285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ReceivedPacketInfo(); 5295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~ReceivedPacketInfo(); 5305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 5315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::ostream& os, const ReceivedPacketInfo& s); 5325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Entropy hash of all packets up to largest observed not including missing 5345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // packets. 5355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketEntropyHash entropy_hash; 5365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The highest packet sequence number we've observed from the peer. 5385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 5395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // In general, this should be the largest packet number we've received. In 5405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the case of truncated acks, we may have to advertise a lower "upper bound" 5415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // than largest received, to avoid implicitly acking missing packets that 5425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // don't fit in the missing packet list due to size limitations. In this 5435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // case, largest_observed may be a packet which is also in the missing packets 5445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // list. 5455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber largest_observed; 5465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Time elapsed since largest_observed was received until this Ack frame was 5486e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) // sent. 5496e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) QuicTime::Delta delta_time_largest_observed; 5505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(satyamshekhar): Can be optimized using an interval set like data 5525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // structure. 5535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The set of packets which we're expecting and have not received. 5545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SequenceNumberSet missing_packets; 5555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Whether the ack had to be truncated when sent. 5575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool is_truncated; 5585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// True if the sequence number is greater than largest_observed or is listed 5615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// as missing. 5625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Always returns false for sequence numbers less than least_unacked. 5635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool NET_EXPORT_PRIVATE IsAwaitingPacket( 5645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ReceivedPacketInfo& received_info, 5655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber sequence_number); 5665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Inserts missing packets between [lower, higher). 5685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void NET_EXPORT_PRIVATE InsertMissingPacketsBetween( 5695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ReceivedPacketInfo* received_info, 5705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber lower, 5715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber higher); 5725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE SentPacketInfo { 5745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SentPacketInfo(); 5755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~SentPacketInfo(); 5765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 5775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::ostream& os, const SentPacketInfo& s); 5785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Entropy hash of all packets up to, but not including, the least unacked 5805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // packet. 5815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketEntropyHash entropy_hash; 58203b57e008b61dfcb1fbad3aea950ae0e001748b0Torne (Richard Coles) // The lowest packet we've sent which is unacked, and we expect an ack for. 5835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber least_unacked; 5845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicAckFrame { 5875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckFrame() {} 588a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // Testing convenience method to construct a QuicAckFrame with all packets 5895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // from least_unacked to largest_observed acked. 5905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckFrame(QuicPacketSequenceNumber largest_observed, 5915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicTime largest_observed_receive_time, 5925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber least_unacked); 5932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 5955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::ostream& os, const QuicAckFrame& s); 5965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SentPacketInfo sent_info; 5985d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) ReceivedPacketInfo received_info; 5997dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch}; 6005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Defines for all types of congestion feedback that will be negotiated in QUIC, 6025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// kTCP MUST be supported by all QUIC implementations to guarantee 100% 6035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// compatibility. 6045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum CongestionFeedbackType { 6055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kTCP, // Used to mimic TCP. 606868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) kInterArrival, // Use additional inter arrival information. 6077dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch kFixRate, // Provided for testing. 6087dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch}; 6095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageTCP { 6115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint16 accumulated_number_of_lost_packets; 6125d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicByteCount receive_window; 6135d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)}; 6145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageInterArrival { 6165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CongestionFeedbackMessageInterArrival(); 6175d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) ~CongestionFeedbackMessageInterArrival(); 6183551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) uint16 accumulated_number_of_lost_packets; 6195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The set of received packets since the last feedback was sent, along with 6205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // their arrival times. 6215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) TimeMap received_packet_times; 6225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageFixRate { 6255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CongestionFeedbackMessageFixRate(); 6265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicBandwidth bitrate; 6275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicCongestionFeedbackFrame { 6305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicCongestionFeedbackFrame(); 6315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~QuicCongestionFeedbackFrame(); 6325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 6342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicCongestionFeedbackFrame& c); 6355d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 636a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) CongestionFeedbackType type; 6375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This should really be a union, but since the inter arrival struct 6385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is non-trivial, C++ prohibits it. 6395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CongestionFeedbackMessageTCP tcp; 6405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CongestionFeedbackMessageInterArrival inter_arrival; 6415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CongestionFeedbackMessageFixRate fix_rate; 6425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicRstStreamFrame { 6455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamFrame() {} 6465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamFrame(QuicStreamId stream_id, QuicRstStreamErrorCode error_code) 6475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : stream_id(stream_id), error_code(error_code) { 6485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_LE(error_code, std::numeric_limits<uint8>::max()); 6497dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch } 6507dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 6517dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QuicStreamId stream_id; 6525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamErrorCode error_code; 6535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string error_details; 6545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicConnectionCloseFrame { 6575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicErrorCode error_code; 6585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string error_details; 6595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(ianswett): Remove this once QUIC_VERSION_11 is removed. 6605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckFrame ack_frame; 6615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicGoAwayFrame { 664c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QuicGoAwayFrame() {} 665868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGoAwayFrame(QuicErrorCode error_code, 6665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId last_good_stream_id, 6675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string& reason); 6685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicErrorCode error_code; 6705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId last_good_stream_id; 6715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string reason_phrase; 6725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// EncryptionLevel enumerates the stages of encryption that a QUIC connection 6755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// progresses through. When retransmitting a packet, the encryption level needs 6762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// to be specified so that it is retransmitted at a level which the peer can 6775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// understand. 6782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum EncryptionLevel { 6795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ENCRYPTION_NONE = 0, 6805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ENCRYPTION_INITIAL = 1, 6815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ENCRYPTION_FORWARD_SECURE = 2, 6825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NUM_ENCRYPTION_LEVELS, 6845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicFrame { 6875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFrame() {} 6887dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch explicit QuicFrame(QuicPaddingFrame* padding_frame) 6895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : type(PADDING_FRAME), 6905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) padding_frame(padding_frame) { 6915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 6925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicStreamFrame* stream_frame) 6935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : type(STREAM_FRAME), 6945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) stream_frame(stream_frame) { 6955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 6965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicAckFrame* frame) 6975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : type(ACK_FRAME), 6985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ack_frame(frame) { 6991320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci } 7001320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci explicit QuicFrame(QuicCongestionFeedbackFrame* frame) 7011320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci : type(CONGESTION_FEEDBACK_FRAME), 7027dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch congestion_feedback_frame(frame) { 7035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicRstStreamFrame* frame) 7057dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch : type(RST_STREAM_FRAME), 7067dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch rst_stream_frame(frame) { 7077dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch } 7087dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch explicit QuicFrame(QuicConnectionCloseFrame* frame) 7097dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch : type(CONNECTION_CLOSE_FRAME), 7107dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch connection_close_frame(frame) { 7117dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch } 7127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch explicit QuicFrame(QuicGoAwayFrame* frame) 7137dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch : type(GOAWAY_FRAME), 7147dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch goaway_frame(frame) { 7155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 7177dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QuicFrameType type; 7187dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch union { 7197dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch QuicPaddingFrame* padding_frame; 7205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame* stream_frame; 7215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckFrame* ack_frame; 7225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicCongestionFeedbackFrame* congestion_feedback_frame; 7235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamFrame* rst_stream_frame; 7245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicConnectionCloseFrame* connection_close_frame; 7255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGoAwayFrame* goaway_frame; 7265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 7275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef std::vector<QuicFrame> QuicFrames; 7305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicFecData { 7325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecData(); 7335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The FEC group number is also the sequence number of the first 7355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FEC protected packet. The last protected packet's sequence number will 7365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // be one less than the sequence number of the FEC packet. 7375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecGroupNumber fec_group; 7385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece redundancy; 7395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicData { 7425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 7435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicData(const char* buffer, size_t length) 7445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : buffer_(buffer), 7455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) length_(length), 7465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) owns_buffer_(false) {} 7475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7485d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicData(char* buffer, size_t length, bool owns_buffer) 749a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) : buffer_(buffer), 7505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) length_(length), 7515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) owns_buffer_(owns_buffer) {} 7525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~QuicData(); 7545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece AsStringPiece() const { 7565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return base::StringPiece(data(), length()); 7575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* data() const { return buffer_; } 7605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length() const { return length_; } 7615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 7635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* buffer_; 7645d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) size_t length_; 7657dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch bool owns_buffer_; 7665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicData); 7685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicPacket : public QuicData { 7715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 7725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static QuicPacket* NewDataPacket( 7735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* buffer, 7745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length, 7755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool owns_buffer, 7765d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicGuidLength guid_length, 7775d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) bool includes_version, 7785d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length) { 7792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return new QuicPacket(buffer, length, owns_buffer, guid_length, 7805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) includes_version, sequence_number_length, false); 7815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static QuicPacket* NewFecPacket( 7845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* buffer, 7855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length, 7865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool owns_buffer, 7875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuidLength guid_length, 7885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool includes_version, 78958537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) QuicSequenceNumberLength sequence_number_length) { 7902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return new QuicPacket(buffer, length, owns_buffer, guid_length, 7915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) includes_version, sequence_number_length, true); 7925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece FecProtectedData() const; 7955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece AssociatedData() const; 7965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece BeforePlaintext() const; 7975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece Plaintext() const; 7985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool is_fec_packet() const { return is_fec_packet_; } 8002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* mutable_data() { return buffer_; } 8025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 8045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacket(char* buffer, 8055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length, 8065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool owns_buffer, 8075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuidLength guid_length, 8085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool includes_version, 8095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 8105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool is_fec_packet) 8115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : QuicData(buffer, length, owns_buffer), 8125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) buffer_(buffer), 8135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) is_fec_packet_(is_fec_packet), 8145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) guid_length_(guid_length), 8155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) includes_version_(includes_version), 8165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) sequence_number_length_(sequence_number_length) {} 8175d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 818a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) char* buffer_; 8195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const bool is_fec_packet_; 8205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QuicGuidLength guid_length_; 8215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const bool includes_version_; 8225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QuicSequenceNumberLength sequence_number_length_; 8235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicPacket); 8255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 8265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicEncryptedPacket : public QuicData { 8285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 8295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicEncryptedPacket(const char* buffer, size_t length) 8305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : QuicData(buffer, length) {} 8315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicEncryptedPacket(char* buffer, size_t length, bool owns_buffer) 8332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : QuicData(buffer, length, owns_buffer) {} 8342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // By default, gtest prints the raw bytes of an object. The bool data 8362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // member (in the base class QuicData) causes this object to have padding 8372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // bytes, which causes the default gtest object printer to read 8382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // uninitialize memory. So we need to teach gtest how to print this object. 8392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 8405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::ostream& os, const QuicEncryptedPacket& s); 841 842 private: 843 DISALLOW_COPY_AND_ASSIGN(QuicEncryptedPacket); 844}; 845 846class NET_EXPORT_PRIVATE RetransmittableFrames { 847 public: 848 RetransmittableFrames(); 849 ~RetransmittableFrames(); 850 851 // Allocates a local copy of the referenced StringPiece has QuicStreamFrame 852 // use it. 853 // Takes ownership of |stream_frame|. 854 const QuicFrame& AddStreamFrame(QuicStreamFrame* stream_frame); 855 // Takes ownership of the frame inside |frame|. 856 const QuicFrame& AddNonStreamFrame(const QuicFrame& frame); 857 const QuicFrames& frames() const { return frames_; } 858 859 void set_encryption_level(EncryptionLevel level); 860 EncryptionLevel encryption_level() const { 861 return encryption_level_; 862 } 863 864 private: 865 QuicFrames frames_; 866 EncryptionLevel encryption_level_; 867 // Data referenced by the StringPiece of a QuicStreamFrame. 868 std::vector<std::string*> stream_data_; 869 870 DISALLOW_COPY_AND_ASSIGN(RetransmittableFrames); 871}; 872 873struct NET_EXPORT_PRIVATE SerializedPacket { 874 SerializedPacket(QuicPacketSequenceNumber sequence_number, 875 QuicSequenceNumberLength sequence_number_length, 876 QuicPacket* packet, 877 QuicPacketEntropyHash entropy_hash, 878 RetransmittableFrames* retransmittable_frames); 879 ~SerializedPacket(); 880 881 QuicPacketSequenceNumber sequence_number; 882 QuicSequenceNumberLength sequence_number_length; 883 QuicPacket* packet; 884 QuicPacketEntropyHash entropy_hash; 885 RetransmittableFrames* retransmittable_frames; 886 887 // If set, these will be called when this packet is ACKed by the peer. 888 std::set<QuicAckNotifier*> notifiers; 889}; 890 891// A struct for functions which consume data payloads and fins. 892struct QuicConsumedData { 893 QuicConsumedData(size_t bytes_consumed, bool fin_consumed) 894 : bytes_consumed(bytes_consumed), 895 fin_consumed(fin_consumed) {} 896 // By default, gtest prints the raw bytes of an object. The bool data 897 // member causes this object to have padding bytes, which causes the 898 // default gtest object printer to read uninitialize memory. So we need 899 // to teach gtest how to print this object. 900 NET_EXPORT_PRIVATE friend std::ostream& operator<<( 901 std::ostream& os, const QuicConsumedData& s); 902 903 // How many bytes were consumed. 904 size_t bytes_consumed; 905 906 // True if an incoming fin was consumed. 907 bool fin_consumed; 908}; 909 910enum WriteStatus { 911 WRITE_STATUS_OK, 912 WRITE_STATUS_BLOCKED, 913 WRITE_STATUS_ERROR, 914}; 915 916// A struct used to return the result of write calls including either the number 917// of bytes written or the error code, depending upon the status. 918struct NET_EXPORT_PRIVATE WriteResult { 919 WriteResult(WriteStatus status, int bytes_written_or_error_code) : 920 status(status), bytes_written(bytes_written_or_error_code) { 921 } 922 923 WriteStatus status; 924 union { 925 int bytes_written; // only valid when status is OK 926 int error_code; // only valid when status is ERROR 927 }; 928}; 929 930} // namespace net 931 932#endif // NET_QUIC_QUIC_PROTOCOL_H_ 933