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) 82a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include <stddef.h> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <limits> 102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include <map> 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <ostream> 122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include <set> 132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include <string> 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <utility> 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 187d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "base/containers/hash_tables.h" 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/logging.h" 20c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)#include "base/strings/string_piece.h" 212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "net/base/int128.h" 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/base/net_export.h" 23f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#include "net/quic/iovector.h" 242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "net/quic/quic_bandwidth.h" 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/quic/quic_time.h" 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace net { 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)using ::operator<<; 302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 3158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles)class QuicAckNotifier; 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class QuicPacket; 33868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)struct QuicPacketHeader; 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicGuid; 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint32 QuicStreamId; 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicStreamOffset; 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicPacketSequenceNumber; 392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef QuicPacketSequenceNumber QuicFecGroupNumber; 402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef uint64 QuicPublicResetNonceProof; 412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef uint8 QuicPacketEntropyHash; 42b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)typedef uint32 QuicHeaderId; 43b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)// QuicTag is the type of a tag in the wire protocol. 44b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)typedef uint32 QuicTag; 45b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)typedef std::vector<QuicTag> QuicTagVector; 46424c4d7b64af9d0d8fd9624f381f469654d5e3d2Torne (Richard Coles)typedef uint32 QuicPriority; 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(rch): Consider Quic specific names for these constants. 490f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Default and initial maximum size in bytes of a QUIC packet. 500f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)const QuicByteCount kDefaultMaxPacketSize = 1200; 510f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// The maximum packet size of any QUIC packet, based on ethernet's max size, 52a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// minus the IP and UDP headers. IPv6 has a 40 byte header, UPD adds an 53a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// additional 8 bytes. This is a total overhead of 48 bytes. Ethernet's 54a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// max packet size is 1500 bytes, 1500 - 48 = 1452. 55a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)const QuicByteCount kMaxPacketSize = 1452; 560f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 570f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Maximum size of the initial congestion window in packets. 580f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)const size_t kDefaultInitialWindow = 10; 59d57369da7c6519fef57db42085f7b42d4c8845c1Torne (Richard Coles)// TODO(ianswett): Temporarily changed to 10 due to a large number of clients 60d57369da7c6519fef57db42085f7b42d4c8845c1Torne (Richard Coles)// mistakenly negotiating 100 initially and suffering the consequences. 61d57369da7c6519fef57db42085f7b42d4c8845c1Torne (Richard Coles)const size_t kMaxInitialWindow = 10; 620f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 63f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// Maximum size of the congestion window, in packets, for TCP congestion control 64f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// algorithms. 65f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)const size_t kMaxTcpCongestionWindow = 200; 66f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 670f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Don't allow a client to suggest an RTT longer than 15 seconds. 68f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)const size_t kMaxInitialRoundTripTimeUs = 15 * kNumMicrosPerSecond; 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Maximum number of open streams per connection. 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kDefaultMaxStreamsPerConnection = 100; 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for public flags in the packet header. 742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kPublicFlagsSize = 1; 752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for version number in the packet header. 762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kQuicVersionSize = 4; 772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for private flags in the packet header. 782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kPrivateFlagsSize = 1; 792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for FEC group in the packet header. 802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kFecGroupSize = 1; 812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for the nonce proof in public reset packet. 822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kPublicResetNonceSize = 8; 832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Signifies that the QuicPacket will contain version of the protocol. 852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const bool kIncludeVersion = true; 862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Index of the first byte in a QUIC packet which is used in hash calculation. 882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kStartOfHashData = 0; 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Limit on the delta between stream IDs. 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicStreamId kMaxStreamIdDelta = 100; 92b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)// Limit on the delta between header IDs. 93b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)const QuicHeaderId kMaxHeaderIdDelta = 100; 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Reserved ID for the crypto stream. 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(rch): ensure that this is not usable by any other streams. 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicStreamId kCryptoStreamId = 1; 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9990dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)// This is the default network timeout a for connection till the crypto 10090dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)// handshake succeeds and the negotiated timeout from the handshake is received. 101868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)const int64 kDefaultInitialTimeoutSecs = 120; // 2 mins. 10290dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)const int64 kDefaultTimeoutSecs = 60 * 10; // 10 minutes. 103868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)const int64 kDefaultMaxTimeForCryptoHandshakeSecs = 5; // 5 secs. 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1051e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// We define an unsigned 16-bit floating point value, inspired by IEEE floats 1061e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// (http://en.wikipedia.org/wiki/Half_precision_floating-point_format), 1071e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// with 5-bit exponent (bias 1), 11-bit mantissa (effective 12 with hidden 1081e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// bit) and denormals, but without signs, transfinites or fractions. Wire format 1091e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// 16 bits (little-endian byte order) are split into exponent (high 5) and 1101e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// mantissa (low 11) and decoded as: 1111e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// uint64 value; 1121e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// if (exponent == 0) value = mantissa; 1131e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// else value = (mantissa | 1 << 11) << (exponent - 1) 1141e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16ExponentBits = 5; 1151e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16MaxExponent = (1 << kUFloat16ExponentBits) - 2; // 30 1161e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16MantissaBits = 16 - kUFloat16ExponentBits; // 11 1171e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16MantissaEffectiveBits = kUFloat16MantissaBits + 1; // 12 1181e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const uint64 kUFloat16MaxValue = // 0x3FFC0000000 1191e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) ((GG_UINT64_C(1) << kUFloat16MantissaEffectiveBits) - 1) << 1201e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) kUFloat16MaxExponent; 1211e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) 12268043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles)enum TransmissionType { 123b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) NOT_RETRANSMISSION, 12468043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles) NACK_RETRANSMISSION, 12568043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles) RTO_RETRANSMISSION, 126c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 127c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 128a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)enum RetransmissionType { 129a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) INITIAL_ENCRYPTION_ONLY, 130a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) ALL_PACKETS 131a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)}; 132a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 133c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum HasRetransmittableData { 134b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) NO_RETRANSMITTABLE_DATA, 135b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) HAS_RETRANSMITTABLE_DATA, 136c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 137c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 138a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)enum IsHandshake { 139a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) NOT_HANDSHAKE, 140a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) IS_HANDSHAKE 141a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)}; 142a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicFrameType { 1442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PADDING_FRAME = 0, 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RST_STREAM_FRAME, 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CONNECTION_CLOSE_FRAME, 1472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) GOAWAY_FRAME, 14858537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) STREAM_FRAME, 14958537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) ACK_FRAME, 15058537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) CONGESTION_FEEDBACK_FRAME, 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NUM_FRAME_TYPES 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 154868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)enum QuicGuidLength { 155868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_0BYTE_GUID = 0, 156868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_1BYTE_GUID = 1, 157868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_4BYTE_GUID = 4, 158868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_8BYTE_GUID = 8 159868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)}; 160868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 161868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)enum InFecGroup { 162868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) NOT_IN_FEC_GROUP, 163868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) IN_FEC_GROUP, 164868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)}; 165868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 166868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)enum QuicSequenceNumberLength { 167868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_1BYTE_SEQUENCE_NUMBER = 1, 168868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_2BYTE_SEQUENCE_NUMBER = 2, 169868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_4BYTE_SEQUENCE_NUMBER = 4, 170868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_6BYTE_SEQUENCE_NUMBER = 6 171868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)}; 172868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 1730f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Used to indicate a QuicSequenceNumberLength using two flag bits. 1740f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)enum QuicSequenceNumberLengthFlags { 1750f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_1BYTE_SEQUENCE = 0, // 00 1760f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_2BYTE_SEQUENCE = 1, // 01 1770f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_4BYTE_SEQUENCE = 1 << 1, // 10 1780f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_6BYTE_SEQUENCE = 1 << 1 | 1, // 11 1790f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)}; 1800f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 1817dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// The public flags are specified in one byte. 1822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicPacketPublicFlags { 1832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_PUBLIC_FLAGS_NONE = 0, 1847dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 1857dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 0: Does the packet header contains version info? 1867dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_VERSION = 1 << 0, 1877dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 1887dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 1: Is this packet a public reset packet? 1897dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_RST = 1 << 1, 1907dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 1917dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bits 2 and 3 specify the length of the GUID as follows: 1927dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----00--: 0 bytes 1937dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----01--: 1 byte 1947dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----10--: 4 bytes 1957dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----11--: 8 bytes 19690dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) PACKET_PUBLIC_FLAGS_0BYTE_GUID = 0, 19790dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) PACKET_PUBLIC_FLAGS_1BYTE_GUID = 1 << 2, 19890dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) PACKET_PUBLIC_FLAGS_4BYTE_GUID = 1 << 3, 19990dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) PACKET_PUBLIC_FLAGS_8BYTE_GUID = 1 << 3 | 1 << 2, 2007dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2017dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bits 4 and 5 describe the packet sequence number length as follows: 2027dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --00----: 1 byte 2037dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --01----: 2 bytes 2047dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --10----: 4 bytes 2057dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --11----: 6 bytes 2060f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_1BYTE_SEQUENCE = PACKET_FLAGS_1BYTE_SEQUENCE << 4, 2070f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_2BYTE_SEQUENCE = PACKET_FLAGS_2BYTE_SEQUENCE << 4, 2080f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_4BYTE_SEQUENCE = PACKET_FLAGS_4BYTE_SEQUENCE << 4, 2090f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_6BYTE_SEQUENCE = PACKET_FLAGS_6BYTE_SEQUENCE << 4, 2107dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2117dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // All bits set (bits 6 and 7 are not currently used): 00111111 2127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_MAX = (1 << 6) - 1 2132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2157dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// The private flags are specified in one byte. 2162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicPacketPrivateFlags { 2172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_PRIVATE_FLAGS_NONE = 0, 2187dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2197dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 0: Does this packet contain an entropy bit? 220868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_PRIVATE_FLAGS_ENTROPY = 1 << 0, 2217dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2227dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 1: Payload is part of an FEC group? 2237dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_FEC_GROUP = 1 << 1, 2247dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2257dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 2: Payload is FEC as opposed to frames? 2267dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_FEC = 1 << 2, 2277dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2287dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // All bits set (bits 3-7 are not currently used): 00000111 2297dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_MAX = (1 << 3) - 1 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 232558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// The available versions of QUIC. Guaranteed that the integer value of the enum 233558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// will match the version number. 234558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// When adding a new version to this enum you should add it to 235ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch// kSupportedQuicVersions (if appropriate), and also add a new case to the 236ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch// helper methods QuicVersionToQuicTag, QuicTagToQuicVersion, and 237ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch// QuicVersionToString. 238558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdochenum QuicVersion { 239558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch // Special case to indicate unknown/unsupported QUIC version. 240558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch QUIC_VERSION_UNSUPPORTED = 0, 241558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 2420f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) QUIC_VERSION_12 = 12, // Current version. 243558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch}; 244558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 245558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// This vector contains QUIC versions which we currently support. 246558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// This should be ordered such that the highest supported version is the first 247558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// element, with subsequent elements in descending order (versions can be 248558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// skipped as necessary). 249f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// 250f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// IMPORTANT: if you are addding to this list, follow the instructions at 251f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// http://sites/quic/adding-and-removing-versions 252f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)static const QuicVersion kSupportedQuicVersions[] = {QUIC_VERSION_12}; 253558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 254558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdochtypedef std::vector<QuicVersion> QuicVersionVector; 255558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 2561e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// Returns a vector of QUIC versions in kSupportedQuicVersions. 2571e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)NET_EXPORT_PRIVATE QuicVersionVector QuicSupportedVersions(); 258c2db58bd994c04d98e4ee2cd7565b71548655fe3Ben Murdoch 259558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// QuicTag is written to and read from the wire, but we prefer to use 260558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// the more readable QuicVersion at other levels. 261558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Helper function which translates from a QuicVersion to a QuicTag. Returns 0 262558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// if QuicVersion is unsupported. 263558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE QuicTag QuicVersionToQuicTag(const QuicVersion version); 264558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 265558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns appropriate QuicVersion from a QuicTag. 266558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns QUIC_VERSION_UNSUPPORTED if version_tag cannot be understood. 267558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE QuicVersion QuicTagToQuicVersion(const QuicTag version_tag); 268558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 269558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Helper function which translates from a QuicVersion to a string. 270558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns strings corresponding to enum names (e.g. QUIC_VERSION_6). 271558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE std::string QuicVersionToString(const QuicVersion version); 272558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 273558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns comma separated list of string representations of QuicVersion enum 2741e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// values in the supplied |versions| vector. 2751e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)NET_EXPORT_PRIVATE std::string QuicVersionVectorToString( 2761e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) const QuicVersionVector& versions); 277558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 278558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Version and Crypto tags are written to the wire with a big-endian 279558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// representation of the name of the tag. For example 280558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// the client hello tag (CHLO) will be written as the 281558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// following 4 bytes: 'C' 'H' 'L' 'O'. Since it is 282558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// stored in memory as a little endian uint32, we need 283558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// to reverse the order of the bytes. 284558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 285558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// MakeQuicTag returns a value given the four bytes. For example: 286558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// MakeQuicTag('C', 'H', 'L', 'O'); 287558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE QuicTag MakeQuicTag(char a, char b, char c, char d); 288558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 289868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Size in bytes of the data or fec packet header. 290868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPacketHeaderSize(QuicPacketHeader header); 291868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 292868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPacketHeaderSize( 293868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length, 294868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool include_version, 295868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 296868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) InFecGroup is_in_fec_group); 297868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 298868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Size in bytes of the public reset packet. 299868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPublicResetPacketSize(); 300868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 301868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Index of the first byte in a QUIC packet of FEC protected data. 302868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetStartOfFecProtectedData( 303868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length, 304868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool include_version, 305868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length); 306868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Index of the first byte in a QUIC packet of encrypted data. 307868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetStartOfEncryptedData( 308868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length, 309868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool include_version, 310868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length); 311868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 312c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum QuicRstStreamErrorCode { 313c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_NO_ERROR = 0, 3142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 315d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // There was some error which halted stream processing. 316d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) QUIC_ERROR_PROCESSING_STREAM, 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We got two fin or reset offsets which did not match. 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_MULTIPLE_TERMINATION_OFFSETS, 3195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We got bad payload and can not respond to it at the protocol level. 3205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_BAD_APPLICATION_PAYLOAD, 321c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Stream closed due to connection error. No reset frame is sent when this 322c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // happens. 323c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_CONNECTION_ERROR, 324c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // GoAway frame sent. No more stream can be created. 325c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_PEER_GOING_AWAY, 326424c4d7b64af9d0d8fd9624f381f469654d5e3d2Torne (Richard Coles) // The stream has been cancelled. 327424c4d7b64af9d0d8fd9624f381f469654d5e3d2Torne (Richard Coles) QUIC_STREAM_CANCELLED, 328c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 329c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // No error. Used as bound while iterating. 330c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_LAST_ERROR, 331c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 3325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3333551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)// These values must remain stable as they are uploaded to UMA histograms. 3343551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)// To add a new error code, use the current value of QUIC_LAST_ERROR and 3353551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)// increment QUIC_LAST_ERROR. 336c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum QuicErrorCode { 337c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_NO_ERROR = 0, 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 339c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Connection has reached an invalid state. 3403551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INTERNAL_ERROR = 1, 341c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // There were data frames after the a fin or reset. 3423551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_STREAM_DATA_AFTER_TERMINATION = 2, 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Control frame is malformed. 3443551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_PACKET_HEADER = 3, 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Frame data is malformed. 3463551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_FRAME_DATA = 4, 3473551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // The packet contained no payload. 3483551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_MISSING_PAYLOAD = 48, 3495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FEC data is malformed. 3503551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_FEC_DATA = 5, 3513551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // STREAM frame data is malformed. 3523551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_STREAM_DATA = 46, 3533551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // RST_STREAM frame data is malformed. 3543551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_RST_STREAM_DATA = 6, 3553551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // CONNECTION_CLOSE frame data is malformed. 3563551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CONNECTION_CLOSE_DATA = 7, 3573551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // GOAWAY frame data is malformed. 3583551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_GOAWAY_DATA = 8, 3593551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // ACK frame data is malformed. 3603551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_ACK_DATA = 9, 3613551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // CONGESTION_FEEDBACK frame data is malformed. 3623551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CONGESTION_FEEDBACK_DATA = 47, 3632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Version negotiation packet is malformed. 3643551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_VERSION_NEGOTIATION_PACKET = 10, 36590dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Public RST packet is malformed. 3663551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_PUBLIC_RST_PACKET = 11, 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error decrypting. 3683551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_DECRYPTION_FAILURE = 12, 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error encrypting. 3703551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_ENCRYPTION_FAILURE = 13, 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The packet exceeded kMaxPacketSize. 3723551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PACKET_TOO_LARGE = 14, 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Data was sent for a stream which did not exist. 3743551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PACKET_FOR_NONEXISTENT_STREAM = 15, 3752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The peer is going away. May be a client or server. 3763551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PEER_GOING_AWAY = 16, 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A stream ID was invalid. 3783551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_STREAM_ID = 17, 379d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // A priority was invalid. 380d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) QUIC_INVALID_PRIORITY = 49, 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Too many streams already open. 3823551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_TOO_MANY_OPEN_STREAMS = 18, 3832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Received public reset for this connection. 3843551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PUBLIC_RESET = 19, 385b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // Invalid protocol version. 3863551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_VERSION = 20, 387b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // Stream reset before headers decompressed. 3883551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_STREAM_RST_BEFORE_HEADERS_DECOMPRESSED = 21, 389b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // The Header ID for a stream was too far from the previous. 3903551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_HEADER_ID = 22, 39190dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Negotiable parameter received during handshake had invalid value. 3923551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_NEGOTIATED_VALUE = 23, 39390dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // There was an error decompressing data. 3943551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_DECOMPRESSION_FAILURE = 24, 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We hit our prenegotiated (or default) timeout 3963551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CONNECTION_TIMED_OUT = 25, 39790dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // There was an error encountered migrating addresses 3983551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_ERROR_MIGRATING_ADDRESS = 26, 39958537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // There was an error while writing to the socket. 4003551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PACKET_WRITE_ERROR = 27, 40158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // There was an error while reading from the socket. 40258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) QUIC_PACKET_READ_ERROR = 51, 403d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // We received a STREAM_FRAME with no data and no fin flag set. 404d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) QUIC_INVALID_STREAM_FRAME = 50, 40590dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) 4065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Crypto errors. 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 40990dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Hanshake failed. 4103551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_HANDSHAKE_FAILED = 28, 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Handshake message contained out of order tags. 4123551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_TAGS_OUT_OF_ORDER = 29, 4132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Handshake message contained too many entries. 4143551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_TOO_MANY_ENTRIES = 30, 4155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Handshake message contained an invalid value length. 4163551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_INVALID_VALUE_LENGTH = 31, 4175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received after the handshake was complete. 4183551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_AFTER_HANDSHAKE_COMPLETE = 32, 4192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with an illegal message tag. 4203551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CRYPTO_MESSAGE_TYPE = 33, 4212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with an illegal parameter. 4223551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CRYPTO_MESSAGE_PARAMETER = 34, 4234e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) // An invalid channel id signature was supplied. 4244e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) QUIC_INVALID_CHANNEL_ID_SIGNATURE = 52, 4252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with a mandatory parameter missing. 4263551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_PARAMETER_NOT_FOUND = 35, 4272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with a parameter that has no overlap 4282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // with the local parameter. 4293551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_PARAMETER_NO_OVERLAP = 36, 4302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received that contained a parameter with too few 4312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // values. 4323551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_INDEX_NOT_FOUND = 37, 433c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // An internal error occured in crypto processing. 4343551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_INTERNAL_ERROR = 38, 435c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // A crypto handshake message specified an unsupported version. 4363551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_VERSION_NOT_SUPPORTED = 39, 437c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // There was no intersection between the crypto primitives supported by the 438c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // peer and ourselves. 4393551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_NO_SUPPORT = 40, 440c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // The server rejected our client hello messages too many times. 4413551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_TOO_MANY_REJECTS = 41, 442c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // The client rejected the server's certificate chain or signature. 4433551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PROOF_INVALID = 42, 444c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // A crypto message was received with a duplicate tag. 4453551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_DUPLICATE_TAG = 43, 446b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // A crypto message was received with the wrong encryption level (i.e. it 447b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // should have been encrypted but was not.) 4483551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_ENCRYPTION_LEVEL_INCORRECT = 44, 449b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // The server config for a server has expired. 4503551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_SERVER_CONFIG_EXPIRED = 45, 4514e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) // We failed to setup the symmetric keys for a connection. 4524e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) QUIC_CRYPTO_SYMMETRIC_KEY_SETUP_FAILED = 53, 453f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // A handshake message arrived, but we are still validating the 454f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // previous handshake message. 455f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QUIC_CRYPTO_MESSAGE_WHILE_VALIDATING_CLIENT_HELLO = 54, 456f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // This connection involved a version negotiation which appears to have been 457f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // tampered with. 458f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QUIC_VERSION_NEGOTIATION_MISMATCH = 55, 459c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 460c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // No error. Used as bound while iterating. 461f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QUIC_LAST_ERROR = 56, 4625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPacketPublicHeader { 4652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketPublicHeader(); 4662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit QuicPacketPublicHeader(const QuicPacketPublicHeader& other); 4672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~QuicPacketPublicHeader(); 4682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Universal header. All QuicPacket headers will have a guid and public flags. 4705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicGuid guid; 471868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length; 4722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool reset_flag; 4732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool version_flag; 474868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length; 475558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch QuicVersionVector versions; 4762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 4772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Header for Data or FEC packets. 479c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPacketHeader { 480c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QuicPacketHeader(); 481c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) explicit QuicPacketHeader(const QuicPacketPublicHeader& header); 4822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 4842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicPacketHeader& s); 4852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketPublicHeader public_header; 4872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool fec_flag; 4882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool entropy_flag; 4892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 4905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber packet_sequence_number; 491868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) InFecGroup is_in_fec_group; 4925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecGroupNumber fec_group; 4935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 495c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPublicResetPacket { 4962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPublicResetPacket() {} 4972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit QuicPublicResetPacket(const QuicPacketPublicHeader& header) 4982a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : public_header(header) {} 4992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketPublicHeader public_header; 5002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber rejected_sequence_number; 5012a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPublicResetNonceProof nonce_proof; 5022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicVersionNegotiationState { 5052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) START_NEGOTIATION = 0, 506ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // Server-side this implies we've sent a version negotiation packet and are 507ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // waiting on the client to select a compatible version. Client-side this 508ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // implies we've gotten a version negotiation packet, are retransmitting the 509ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // initial packets with a supported version and are waiting for our first 510ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // packet from the server. 511ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch NEGOTIATION_IN_PROGRESS, 512ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // This indicates this endpoint has received a packet from the peer with a 513ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // version this endpoint supports. Version negotiation is complete, and the 514ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // version number will no longer be sent with future packets. 5152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NEGOTIATED_VERSION 5162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef QuicPacketPublicHeader QuicVersionNegotiationPacket; 5192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// A padding frame contains no payload. 5212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPaddingFrame { 5222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicStreamFrame { 5255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame(); 526f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QuicStreamFrame(const QuicStreamFrame& frame); 5275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame(QuicStreamId stream_id, 5285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fin, 5292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamOffset offset, 530f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) IOVector data); 531f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 532f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Returns a copy of the IOVector |data| as a heap-allocated string. 533f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Caller must take ownership of the returned string. 534f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) std::string* GetDataAsString() const; 5355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId stream_id; 5375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fin; 5382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamOffset offset; // Location of this data in the stream. 539f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) IOVector data; 54058537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 54158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // If this is set, then when this packet is ACKed the AckNotifier will be 54258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // informed. 54358537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) QuicAckNotifier* notifier; 5445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// TODO(ianswett): Re-evaluate the trade-offs of hash_set vs set when framing 5472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// is finalized. 5482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef std::set<QuicPacketSequenceNumber> SequenceNumberSet; 5492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// TODO(pwestin): Add a way to enforce the max size of this map. 5502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef std::map<QuicPacketSequenceNumber, QuicTime> TimeMap; 5512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE ReceivedPacketInfo { 5535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ReceivedPacketInfo(); 5545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~ReceivedPacketInfo(); 5552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 5562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const ReceivedPacketInfo& s); 5572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Entropy hash of all packets up to largest observed not including missing 5592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // packets. 5602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 5612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The highest packet sequence number we've observed from the peer. 5632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // 5642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // In general, this should be the largest packet number we've received. In 5652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // the case of truncated acks, we may have to advertise a lower "upper bound" 5662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // than largest received, to avoid implicitly acking missing packets that 5672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // don't fit in the missing packet list due to size limitations. In this 5682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // case, largest_observed may be a packet which is also in the missing packets 5692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // list. 5702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber largest_observed; 5712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Time elapsed since largest_observed was received until this Ack frame was 5732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // sent. 5742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicTime::Delta delta_time_largest_observed; 5752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // TODO(satyamshekhar): Can be optimized using an interval set like data 5772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // structure. 5785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The set of packets which we're expecting and have not received. 5792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) SequenceNumberSet missing_packets; 5800f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 5810f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) // Whether the ack had to be truncated when sent. 5820f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) bool is_truncated; 5835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// True if the sequence number is greater than largest_observed or is listed 5862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// as missing. 5872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Always returns false for sequence numbers less than least_unacked. 5882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)bool NET_EXPORT_PRIVATE IsAwaitingPacket( 5892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const ReceivedPacketInfo& received_info, 5902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber sequence_number); 5912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5922a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Inserts missing packets between [lower, higher). 5932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void NET_EXPORT_PRIVATE InsertMissingPacketsBetween( 5942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ReceivedPacketInfo* received_info, 5952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber lower, 5962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber higher); 5972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE SentPacketInfo { 5995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SentPacketInfo(); 6005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~SentPacketInfo(); 6012a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 6022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const SentPacketInfo& s); 6032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Entropy hash of all packets up to, but not including, the least unacked 6052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // packet. 6062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 6075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The lowest packet we've sent which is unacked, and we expect an ack for. 6085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber least_unacked; 6092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 6102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicAckFrame { 6122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicAckFrame() {} 6132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Testing convenience method to construct a QuicAckFrame with all packets 6142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // from least_unacked to largest_observed acked. 6152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicAckFrame(QuicPacketSequenceNumber largest_observed, 6162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicTime largest_observed_receive_time, 6172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber least_unacked); 6182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 6202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicAckFrame& s); 6212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) SentPacketInfo sent_info; 6232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ReceivedPacketInfo received_info; 6245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Defines for all types of congestion feedback that will be negotiated in QUIC, 6277dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// kTCP MUST be supported by all QUIC implementations to guarantee 100% 6285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// compatibility. 6295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum CongestionFeedbackType { 6305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kTCP, // Used to mimic TCP. 6315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kInterArrival, // Use additional inter arrival information. 6325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kFixRate, // Provided for testing. 6335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageTCP { 6365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint16 accumulated_number_of_lost_packets; 6372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicByteCount receive_window; 6385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageInterArrival { 6412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageInterArrival(); 6422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~CongestionFeedbackMessageInterArrival(); 6435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint16 accumulated_number_of_lost_packets; 6442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The set of received packets since the last feedback was sent, along with 6452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // their arrival times. 6462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) TimeMap received_packet_times; 6475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageFixRate { 6502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageFixRate(); 6512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicBandwidth bitrate; 6525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicCongestionFeedbackFrame { 6552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicCongestionFeedbackFrame(); 6562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~QuicCongestionFeedbackFrame(); 6575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 6592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicCongestionFeedbackFrame& c); 6605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackType type; 6622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // This should really be a union, but since the inter arrival struct 6632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // is non-trivial, C++ prohibits it. 6642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageTCP tcp; 6652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageInterArrival inter_arrival; 6662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageFixRate fix_rate; 6675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicRstStreamFrame { 6705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamFrame() {} 671c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QuicRstStreamFrame(QuicStreamId stream_id, QuicRstStreamErrorCode error_code) 6722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : stream_id(stream_id), error_code(error_code) { 6735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_LE(error_code, std::numeric_limits<uint8>::max()); 6745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 6755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId stream_id; 677c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QuicRstStreamErrorCode error_code; 6785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string error_details; 6795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicConnectionCloseFrame { 6825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicErrorCode error_code; 6835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string error_details; 6842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 6852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicGoAwayFrame { 6872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicGoAwayFrame() {} 6882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicGoAwayFrame(QuicErrorCode error_code, 6892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamId last_good_stream_id, 6902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::string& reason); 6912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6922a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicErrorCode error_code; 6932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamId last_good_stream_id; 6942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::string reason_phrase; 6955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 697c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// EncryptionLevel enumerates the stages of encryption that a QUIC connection 698c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// progresses through. When retransmitting a packet, the encryption level needs 699c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// to be specified so that it is retransmitted at a level which the peer can 700c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// understand. 701c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum EncryptionLevel { 702c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) ENCRYPTION_NONE = 0, 703c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) ENCRYPTION_INITIAL = 1, 704c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) ENCRYPTION_FORWARD_SECURE = 2, 705c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 706c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) NUM_ENCRYPTION_LEVELS, 707c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 708c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 7095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicFrame { 7105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFrame() {} 7112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit QuicFrame(QuicPaddingFrame* padding_frame) 7122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : type(PADDING_FRAME), 7132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) padding_frame(padding_frame) { 7142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) } 7155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicStreamFrame* stream_frame) 7162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : type(STREAM_FRAME), 7172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) stream_frame(stream_frame) { 7185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicAckFrame* frame) 7202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : type(ACK_FRAME), 7212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ack_frame(frame) { 7222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) } 7232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit QuicFrame(QuicCongestionFeedbackFrame* frame) 7242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : type(CONGESTION_FEEDBACK_FRAME), 7252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) congestion_feedback_frame(frame) { 7265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicRstStreamFrame* frame) 7285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : type(RST_STREAM_FRAME), 7295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) rst_stream_frame(frame) { 7305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit QuicFrame(QuicConnectionCloseFrame* frame) 7325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : type(CONNECTION_CLOSE_FRAME), 7335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) connection_close_frame(frame) { 7345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit QuicFrame(QuicGoAwayFrame* frame) 7362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : type(GOAWAY_FRAME), 7372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) goaway_frame(frame) { 7382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) } 7395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFrameType type; 7415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 7422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPaddingFrame* padding_frame; 7435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame* stream_frame; 7445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckFrame* ack_frame; 7452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicCongestionFeedbackFrame* congestion_feedback_frame; 7465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamFrame* rst_stream_frame; 7475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicConnectionCloseFrame* connection_close_frame; 7482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicGoAwayFrame* goaway_frame; 7495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 7505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef std::vector<QuicFrame> QuicFrames; 7535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicFecData { 7555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecData(); 7565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The FEC group number is also the sequence number of the first 7582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // FEC protected packet. The last protected packet's sequence number will 7592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // be one less than the sequence number of the FEC packet. 7605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecGroupNumber fec_group; 7615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece redundancy; 7625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicData { 7655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 7665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicData(const char* buffer, size_t length) 7675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : buffer_(buffer), 7685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) length_(length), 7692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) owns_buffer_(false) {} 7705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicData(char* buffer, size_t length, bool owns_buffer) 7725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : buffer_(buffer), 7735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) length_(length), 7742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) owns_buffer_(owns_buffer) {} 7755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~QuicData(); 7775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece AsStringPiece() const { 7795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return base::StringPiece(data(), length()); 7805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 7815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* data() const { return buffer_; } 7835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length() const { return length_; } 7845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 7865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* buffer_; 7875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length_; 7885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool owns_buffer_; 7895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicData); 7915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicPacket : public QuicData { 7945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 795868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) static QuicPacket* NewDataPacket( 796868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) char* buffer, 797868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) size_t length, 798868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool owns_buffer, 799868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length, 800868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool includes_version, 801868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length) { 802868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) return new QuicPacket(buffer, length, owns_buffer, guid_length, 803868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) includes_version, sequence_number_length, false); 8045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 8055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 806868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) static QuicPacket* NewFecPacket( 807868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) char* buffer, 808868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) size_t length, 809868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool owns_buffer, 810868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length, 811868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool includes_version, 812868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length) { 813868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) return new QuicPacket(buffer, length, owns_buffer, guid_length, 814868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) includes_version, sequence_number_length, true); 8155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 8165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece FecProtectedData() const; 8182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece AssociatedData() const; 8192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece BeforePlaintext() const; 8202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece Plaintext() const; 8215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool is_fec_packet() const { return is_fec_packet_; } 8232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* mutable_data() { return buffer_; } 8255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 8272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacket(char* buffer, 8282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) size_t length, 8292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool owns_buffer, 830868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicGuidLength guid_length, 8312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool includes_version, 832868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 8332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool is_fec_packet) 8342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : QuicData(buffer, length, owns_buffer), 8352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) buffer_(buffer), 8362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) is_fec_packet_(is_fec_packet), 837868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) guid_length_(guid_length), 838868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) includes_version_(includes_version), 839868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) sequence_number_length_(sequence_number_length) {} 8402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* buffer_; 8422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const bool is_fec_packet_; 843868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) const QuicGuidLength guid_length_; 8442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const bool includes_version_; 845868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) const QuicSequenceNumberLength sequence_number_length_; 8465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicPacket); 8485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 8495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicEncryptedPacket : public QuicData { 8515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 8525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicEncryptedPacket(const char* buffer, size_t length) 8532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : QuicData(buffer, length) {} 8545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicEncryptedPacket(char* buffer, size_t length, bool owns_buffer) 8562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : QuicData(buffer, length, owns_buffer) {} 8575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 858f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Clones the packet into a new packet which owns the buffer. 859f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QuicEncryptedPacket* Clone() const; 860f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 8612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // By default, gtest prints the raw bytes of an object. The bool data 8622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // member (in the base class QuicData) causes this object to have padding 8632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // bytes, which causes the default gtest object printer to read 8642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // uninitialize memory. So we need to teach gtest how to print this object. 8652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 8662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicEncryptedPacket& s); 8675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 8695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicEncryptedPacket); 8705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 8715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class NET_EXPORT_PRIVATE RetransmittableFrames { 8732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public: 8742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) RetransmittableFrames(); 8752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~RetransmittableFrames(); 8762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Allocates a local copy of the referenced StringPiece has QuicStreamFrame 8782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // use it. 8792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Takes ownership of |stream_frame|. 8802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const QuicFrame& AddStreamFrame(QuicStreamFrame* stream_frame); 8812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Takes ownership of the frame inside |frame|. 8822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const QuicFrame& AddNonStreamFrame(const QuicFrame& frame); 8832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const QuicFrames& frames() const { return frames_; } 8842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 885c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) void set_encryption_level(EncryptionLevel level); 886c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) EncryptionLevel encryption_level() const { 887c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) return encryption_level_; 888c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) } 889c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 8902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) private: 8912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicFrames frames_; 892c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) EncryptionLevel encryption_level_; 8932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Data referenced by the StringPiece of a QuicStreamFrame. 8942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::vector<std::string*> stream_data_; 8952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(RetransmittableFrames); 8972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 8982a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 8992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE SerializedPacket { 9002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) SerializedPacket(QuicPacketSequenceNumber sequence_number, 9013551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 9022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacket* packet, 9032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash, 90458537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) RetransmittableFrames* retransmittable_frames); 90558537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) ~SerializedPacket(); 9062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber sequence_number; 9083551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length; 9092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacket* packet; 9102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 9112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) RetransmittableFrames* retransmittable_frames; 91258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 91358537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // If set, these will be called when this packet is ACKed by the peer. 91458537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) std::set<QuicAckNotifier*> notifiers; 9152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 9162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// A struct for functions which consume data payloads and fins. 9182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct QuicConsumedData { 9192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicConsumedData(size_t bytes_consumed, bool fin_consumed) 9202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) : bytes_consumed(bytes_consumed), 9212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) fin_consumed(fin_consumed) {} 9222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // By default, gtest prints the raw bytes of an object. The bool data 9232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // member causes this object to have padding bytes, which causes the 9242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // default gtest object printer to read uninitialize memory. So we need 9252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // to teach gtest how to print this object. 9262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 9272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicConsumedData& s); 9282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 92958537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // How many bytes were consumed. 9302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) size_t bytes_consumed; 93158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 93258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // True if an incoming fin was consumed. 9332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool fin_consumed; 9342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 9352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9364e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)enum WriteStatus { 9374e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WRITE_STATUS_OK, 9384e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WRITE_STATUS_BLOCKED, 9394e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WRITE_STATUS_ERROR, 9404e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)}; 9414e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 9424e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)// A struct used to return the result of write calls including either the number 9434e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)// of bytes written or the error code, depending upon the status. 9444e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)struct NET_EXPORT_PRIVATE WriteResult { 9454e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WriteResult(WriteStatus status, int bytes_written_or_error_code) : 9464e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) status(status), bytes_written(bytes_written_or_error_code) { 9474e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) } 9484e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 9494e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WriteStatus status; 9504e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) union { 9514e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) int bytes_written; // only valid when status is OK 9524e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) int error_code; // only valid when status is ERROR 9534e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) }; 9544e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)}; 9554e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 9565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace net 9575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // NET_QUIC_QUIC_PROTOCOL_H_ 959