quic_protocol.h revision 5c02ac1a9c1b504631c0a3d2b6e737b5d738bae1
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" 225d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#include "net/base/ip_endpoint.h" 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/base/net_export.h" 24f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#include "net/quic/iovector.h" 252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "net/quic/quic_bandwidth.h" 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/quic/quic_time.h" 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace net { 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)using ::operator<<; 312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 3258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles)class QuicAckNotifier; 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class QuicPacket; 34868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)struct QuicPacketHeader; 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 36a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles)typedef uint64 QuicConnectionId; 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint32 QuicStreamId; 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicStreamOffset; 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef uint64 QuicPacketSequenceNumber; 402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef QuicPacketSequenceNumber QuicFecGroupNumber; 412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef uint64 QuicPublicResetNonceProof; 422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef uint8 QuicPacketEntropyHash; 43b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)typedef uint32 QuicHeaderId; 44b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)// QuicTag is the type of a tag in the wire protocol. 45b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)typedef uint32 QuicTag; 46b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)typedef std::vector<QuicTag> QuicTagVector; 475d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)typedef std::map<QuicTag, std::string> QuicTagValueMap; 485d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// TODO(rtenneti): Didn't use SpdyPriority because SpdyPriority is uint8 and 495d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// QuicPriority is uint32. Use SpdyPriority when we change the QUIC_VERSION. 50424c4d7b64af9d0d8fd9624f381f469654d5e3d2Torne (Richard Coles)typedef uint32 QuicPriority; 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(rch): Consider Quic specific names for these constants. 530f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Default and initial maximum size in bytes of a QUIC packet. 540f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)const QuicByteCount kDefaultMaxPacketSize = 1200; 550f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// The maximum packet size of any QUIC packet, based on ethernet's max size, 56a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// minus the IP and UDP headers. IPv6 has a 40 byte header, UPD adds an 57a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// additional 8 bytes. This is a total overhead of 48 bytes. Ethernet's 58a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// max packet size is 1500 bytes, 1500 - 48 = 1452. 59a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)const QuicByteCount kMaxPacketSize = 1452; 600f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 610f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Maximum size of the initial congestion window in packets. 620f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)const size_t kDefaultInitialWindow = 10; 630529e5d033099cbfc42635f6f6183833b09dff6eBen Murdochconst uint32 kMaxInitialWindow = 100; 640f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 65e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch// Default size of initial flow control window. 66e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdochconst uint32 kDefaultFlowControlSendWindow = 16 * 1024; // 16 KB 67e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch 68f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// Maximum size of the congestion window, in packets, for TCP congestion control 69f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// algorithms. 70f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)const size_t kMaxTcpCongestionWindow = 200; 71f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 720f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Don't allow a client to suggest an RTT longer than 15 seconds. 730529e5d033099cbfc42635f6f6183833b09dff6eBen Murdochconst uint32 kMaxInitialRoundTripTimeUs = 15 * kNumMicrosPerSecond; 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Maximum number of open streams per connection. 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const size_t kDefaultMaxStreamsPerConnection = 100; 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for public flags in the packet header. 792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kPublicFlagsSize = 1; 802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for version number in the packet header. 812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kQuicVersionSize = 4; 822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for private flags in the packet header. 832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kPrivateFlagsSize = 1; 842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Number of bytes reserved for FEC group in the packet header. 852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kFecGroupSize = 1; 862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Signifies that the QuicPacket will contain version of the protocol. 882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const bool kIncludeVersion = true; 892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Index of the first byte in a QUIC packet which is used in hash calculation. 912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const size_t kStartOfHashData = 0; 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Limit on the delta between stream IDs. 94e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdochconst QuicStreamId kMaxStreamIdDelta = 200; 95b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles)// Limit on the delta between header IDs. 96e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdochconst QuicHeaderId kMaxHeaderIdDelta = 200; 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Reserved ID for the crypto stream. 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const QuicStreamId kCryptoStreamId = 1; 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1015d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// Reserved ID for the headers stream. 1025d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)const QuicStreamId kHeadersStreamId = 3; 1035d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 10490dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)// This is the default network timeout a for connection till the crypto 10590dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)// handshake succeeds and the negotiated timeout from the handshake is received. 106868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)const int64 kDefaultInitialTimeoutSecs = 120; // 2 mins. 10790dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles)const int64 kDefaultTimeoutSecs = 60 * 10; // 10 minutes. 108868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)const int64 kDefaultMaxTimeForCryptoHandshakeSecs = 5; // 5 secs. 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1100529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch// Default ping timeout. 1110529e5d033099cbfc42635f6f6183833b09dff6eBen Murdochconst int64 kPingTimeoutSecs = 15; // 15 secs. 1120529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch 1131e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// We define an unsigned 16-bit floating point value, inspired by IEEE floats 1141e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// (http://en.wikipedia.org/wiki/Half_precision_floating-point_format), 1151e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// with 5-bit exponent (bias 1), 11-bit mantissa (effective 12 with hidden 1161e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// bit) and denormals, but without signs, transfinites or fractions. Wire format 1171e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// 16 bits (little-endian byte order) are split into exponent (high 5) and 1181e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// mantissa (low 11) and decoded as: 1191e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// uint64 value; 1201e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// if (exponent == 0) value = mantissa; 1211e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// else value = (mantissa | 1 << 11) << (exponent - 1) 1221e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16ExponentBits = 5; 1231e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16MaxExponent = (1 << kUFloat16ExponentBits) - 2; // 30 1241e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16MantissaBits = 16 - kUFloat16ExponentBits; // 11 1251e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const int kUFloat16MantissaEffectiveBits = kUFloat16MantissaBits + 1; // 12 1261e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)const uint64 kUFloat16MaxValue = // 0x3FFC0000000 1271e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) ((GG_UINT64_C(1) << kUFloat16MantissaEffectiveBits) - 1) << 1281e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) kUFloat16MaxExponent; 1291e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) 13068043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles)enum TransmissionType { 131b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) NOT_RETRANSMISSION, 13223730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) FIRST_TRANSMISSION_TYPE = NOT_RETRANSMISSION, 13323730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) HANDSHAKE_RETRANSMISSION, // Retransmits due to handshake timeouts. 13423730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) ALL_UNACKED_RETRANSMISSION, // Retransmits of all unacked packets. 13523730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) LOSS_RETRANSMISSION, // Retransmits due to loss detection. 13623730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) RTO_RETRANSMISSION, // Retransmits due to retransmit time out. 13723730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) TLP_RETRANSMISSION, // Tail loss probes. 13823730a6e56a168d1879203e4b3819bb36e3d8f1fTorne (Richard Coles) LAST_TRANSMISSION_TYPE = TLP_RETRANSMISSION, 139c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 140c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 141a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)enum RetransmissionType { 142a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) INITIAL_ENCRYPTION_ONLY, 143a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) ALL_PACKETS 144a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)}; 145a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 146c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum HasRetransmittableData { 147b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) NO_RETRANSMITTABLE_DATA, 148b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) HAS_RETRANSMITTABLE_DATA, 149c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 150c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 151a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)enum IsHandshake { 152a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) NOT_HANDSHAKE, 153a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) IS_HANDSHAKE 154a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)}; 155a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles) 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum QuicFrameType { 1575d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // Regular frame types. The values set here cannot change without the 1585d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // introduction of a new QUIC version. 1592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PADDING_FRAME = 0, 1605d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) RST_STREAM_FRAME = 1, 1615d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) CONNECTION_CLOSE_FRAME = 2, 1625d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) GOAWAY_FRAME = 3, 1635d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) WINDOW_UPDATE_FRAME = 4, 1645d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) BLOCKED_FRAME = 5, 165a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) STOP_WAITING_FRAME = 6, 1660529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch PING_FRAME = 7, 1675d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 1685d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // STREAM, ACK, and CONGESTION_FEEDBACK frames are special frames. They are 1695d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // encoded differently on the wire and their values do not need to be stable. 17058537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) STREAM_FRAME, 17158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) ACK_FRAME, 17258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) CONGESTION_FEEDBACK_FRAME, 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NUM_FRAME_TYPES 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 176a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles)enum QuicConnectionIdLength { 177a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_0BYTE_CONNECTION_ID = 0, 178a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_1BYTE_CONNECTION_ID = 1, 179a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_4BYTE_CONNECTION_ID = 4, 180a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_8BYTE_CONNECTION_ID = 8 181868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)}; 182868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 183868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)enum InFecGroup { 184868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) NOT_IN_FEC_GROUP, 185868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) IN_FEC_GROUP, 186868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)}; 187868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 188868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)enum QuicSequenceNumberLength { 189868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_1BYTE_SEQUENCE_NUMBER = 1, 190868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_2BYTE_SEQUENCE_NUMBER = 2, 191868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_4BYTE_SEQUENCE_NUMBER = 4, 192868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_6BYTE_SEQUENCE_NUMBER = 6 193868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)}; 194868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 1950f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)// Used to indicate a QuicSequenceNumberLength using two flag bits. 1960f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)enum QuicSequenceNumberLengthFlags { 1970f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_1BYTE_SEQUENCE = 0, // 00 1980f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_2BYTE_SEQUENCE = 1, // 01 1990f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_4BYTE_SEQUENCE = 1 << 1, // 10 2000f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_FLAGS_6BYTE_SEQUENCE = 1 << 1 | 1, // 11 2010f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles)}; 2020f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 2037dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// The public flags are specified in one byte. 2042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicPacketPublicFlags { 2052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_PUBLIC_FLAGS_NONE = 0, 2067dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2077dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 0: Does the packet header contains version info? 2087dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_VERSION = 1 << 0, 2097dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2107dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 1: Is this packet a public reset packet? 2117dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_RST = 1 << 1, 2127dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 213a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // Bits 2 and 3 specify the length of the ConnectionId as follows: 2147dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----00--: 0 bytes 2157dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----01--: 1 byte 2167dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----10--: 4 bytes 2177dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // ----11--: 8 bytes 218a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_PUBLIC_FLAGS_0BYTE_CONNECTION_ID = 0, 219a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_PUBLIC_FLAGS_1BYTE_CONNECTION_ID = 1 << 2, 220a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_PUBLIC_FLAGS_4BYTE_CONNECTION_ID = 1 << 3, 221a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) PACKET_PUBLIC_FLAGS_8BYTE_CONNECTION_ID = 1 << 3 | 1 << 2, 2227dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2237dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bits 4 and 5 describe the packet sequence number length as follows: 2247dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --00----: 1 byte 2257dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --01----: 2 bytes 2267dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --10----: 4 bytes 2277dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // --11----: 6 bytes 2280f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_1BYTE_SEQUENCE = PACKET_FLAGS_1BYTE_SEQUENCE << 4, 2290f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_2BYTE_SEQUENCE = PACKET_FLAGS_2BYTE_SEQUENCE << 4, 2300f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_4BYTE_SEQUENCE = PACKET_FLAGS_4BYTE_SEQUENCE << 4, 2310f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) PACKET_PUBLIC_FLAGS_6BYTE_SEQUENCE = PACKET_FLAGS_6BYTE_SEQUENCE << 4, 2327dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2337dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // All bits set (bits 6 and 7 are not currently used): 00111111 2347dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PUBLIC_FLAGS_MAX = (1 << 6) - 1 2352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2377dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// The private flags are specified in one byte. 2382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicPacketPrivateFlags { 2392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) PACKET_PRIVATE_FLAGS_NONE = 0, 2407dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2417dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 0: Does this packet contain an entropy bit? 242868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) PACKET_PRIVATE_FLAGS_ENTROPY = 1 << 0, 2437dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2447dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 1: Payload is part of an FEC group? 2457dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_FEC_GROUP = 1 << 1, 2467dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2477dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // Bit 2: Payload is FEC as opposed to frames? 2487dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_FEC = 1 << 2, 2497dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch 2507dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch // All bits set (bits 3-7 are not currently used): 00000111 2517dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch PACKET_PRIVATE_FLAGS_MAX = (1 << 3) - 1 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 254558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// The available versions of QUIC. Guaranteed that the integer value of the enum 255558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// will match the version number. 256558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// When adding a new version to this enum you should add it to 257ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch// kSupportedQuicVersions (if appropriate), and also add a new case to the 258ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch// helper methods QuicVersionToQuicTag, QuicTagToQuicVersion, and 259ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch// QuicVersionToString. 260558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdochenum QuicVersion { 261558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch // Special case to indicate unknown/unsupported QUIC version. 262558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch QUIC_VERSION_UNSUPPORTED = 0, 263558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 264a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QUIC_VERSION_15 = 15, 265e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch QUIC_VERSION_16 = 16, 2660529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QUIC_VERSION_17 = 17, 2670529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QUIC_VERSION_18 = 18, // Current version. 268558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch}; 269558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 270558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// This vector contains QUIC versions which we currently support. 271558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// This should be ordered such that the highest supported version is the first 272558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// element, with subsequent elements in descending order (versions can be 273558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// skipped as necessary). 274f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// 275f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// IMPORTANT: if you are addding to this list, follow the instructions at 276f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)// http://sites/quic/adding-and-removing-versions 2770529e5d033099cbfc42635f6f6183833b09dff6eBen Murdochstatic const QuicVersion kSupportedQuicVersions[] = {QUIC_VERSION_18, 2780529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QUIC_VERSION_17, 279e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch QUIC_VERSION_16, 2805c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu QUIC_VERSION_15}; 281558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 282558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdochtypedef std::vector<QuicVersion> QuicVersionVector; 283558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 2841e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// Returns a vector of QUIC versions in kSupportedQuicVersions. 2851e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)NET_EXPORT_PRIVATE QuicVersionVector QuicSupportedVersions(); 286c2db58bd994c04d98e4ee2cd7565b71548655fe3Ben Murdoch 287558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// QuicTag is written to and read from the wire, but we prefer to use 288558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// the more readable QuicVersion at other levels. 289558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Helper function which translates from a QuicVersion to a QuicTag. Returns 0 290558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// if QuicVersion is unsupported. 291558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE QuicTag QuicVersionToQuicTag(const QuicVersion version); 292558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 293558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns appropriate QuicVersion from a QuicTag. 294558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns QUIC_VERSION_UNSUPPORTED if version_tag cannot be understood. 295558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE QuicVersion QuicTagToQuicVersion(const QuicTag version_tag); 296558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 297558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Helper function which translates from a QuicVersion to a string. 298558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns strings corresponding to enum names (e.g. QUIC_VERSION_6). 299558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE std::string QuicVersionToString(const QuicVersion version); 300558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 301558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Returns comma separated list of string representations of QuicVersion enum 3021e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// values in the supplied |versions| vector. 3031e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)NET_EXPORT_PRIVATE std::string QuicVersionVectorToString( 3041e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) const QuicVersionVector& versions); 305558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 306558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// Version and Crypto tags are written to the wire with a big-endian 307558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// representation of the name of the tag. For example 308558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// the client hello tag (CHLO) will be written as the 309558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// following 4 bytes: 'C' 'H' 'L' 'O'. Since it is 310558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// stored in memory as a little endian uint32, we need 311558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// to reverse the order of the bytes. 312558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 313558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// MakeQuicTag returns a value given the four bytes. For example: 314558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch// MakeQuicTag('C', 'H', 'L', 'O'); 315558790d6acca3451cf3a6b497803a5f07d0bec58Ben MurdochNET_EXPORT_PRIVATE QuicTag MakeQuicTag(char a, char b, char c, char d); 316558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch 317868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Size in bytes of the data or fec packet header. 3185d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPacketHeaderSize(const QuicPacketHeader& header); 319868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 320868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetPacketHeaderSize( 321a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length, 322868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool include_version, 323868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 324868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) InFecGroup is_in_fec_group); 325868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 326868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Index of the first byte in a QUIC packet of FEC protected data. 327868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetStartOfFecProtectedData( 328a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length, 329868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool include_version, 330868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length); 331868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)// Index of the first byte in a QUIC packet of encrypted data. 332868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)NET_EXPORT_PRIVATE size_t GetStartOfEncryptedData( 333a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length, 334868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool include_version, 335868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length); 336868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) 337c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum QuicRstStreamErrorCode { 338c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_NO_ERROR = 0, 3392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 340d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // There was some error which halted stream processing. 341d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) QUIC_ERROR_PROCESSING_STREAM, 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We got two fin or reset offsets which did not match. 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_MULTIPLE_TERMINATION_OFFSETS, 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We got bad payload and can not respond to it at the protocol level. 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QUIC_BAD_APPLICATION_PAYLOAD, 346c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Stream closed due to connection error. No reset frame is sent when this 347c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // happens. 348c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_CONNECTION_ERROR, 349c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // GoAway frame sent. No more stream can be created. 350c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_PEER_GOING_AWAY, 351424c4d7b64af9d0d8fd9624f381f469654d5e3d2Torne (Richard Coles) // The stream has been cancelled. 352424c4d7b64af9d0d8fd9624f381f469654d5e3d2Torne (Richard Coles) QUIC_STREAM_CANCELLED, 3530529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch // Sending a RST to allow for proper flow control accounting. 3540529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QUIC_RST_FLOW_CONTROL_ACCOUNTING, 355c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 356c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // No error. Used as bound while iterating. 357c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_STREAM_LAST_ERROR, 358c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3600529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch// Because receiving an unknown QuicRstStreamErrorCode results in connection 3610529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch// teardown, we use this to make sure any errors predating a given version are 3620529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch// downgraded to the most appropriate existing error. 3630529e5d033099cbfc42635f6f6183833b09dff6eBen MurdochNET_EXPORT_PRIVATE QuicRstStreamErrorCode AdjustErrorForVersion( 3640529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QuicRstStreamErrorCode error_code, 3650529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QuicVersion version); 3660529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch 3673551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)// These values must remain stable as they are uploaded to UMA histograms. 3683551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)// To add a new error code, use the current value of QUIC_LAST_ERROR and 3693551c9c881056c480085172ff9840cab31610854Torne (Richard Coles)// increment QUIC_LAST_ERROR. 370c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum QuicErrorCode { 371c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QUIC_NO_ERROR = 0, 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 373c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Connection has reached an invalid state. 3743551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INTERNAL_ERROR = 1, 375c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // There were data frames after the a fin or reset. 3763551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_STREAM_DATA_AFTER_TERMINATION = 2, 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Control frame is malformed. 3783551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_PACKET_HEADER = 3, 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Frame data is malformed. 3803551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_FRAME_DATA = 4, 3813551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // The packet contained no payload. 3823551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_MISSING_PAYLOAD = 48, 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FEC data is malformed. 3843551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_FEC_DATA = 5, 3853551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // STREAM frame data is malformed. 3863551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_STREAM_DATA = 46, 3875c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu // STREAM frame data is not encrypted. 3885c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu QUIC_UNENCRYPTED_STREAM_DATA = 61, 3893551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // RST_STREAM frame data is malformed. 3903551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_RST_STREAM_DATA = 6, 3913551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // CONNECTION_CLOSE frame data is malformed. 3923551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CONNECTION_CLOSE_DATA = 7, 3933551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // GOAWAY frame data is malformed. 3943551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_GOAWAY_DATA = 8, 3955d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // WINDOW_UPDATE frame data is malformed. 3965d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_INVALID_WINDOW_UPDATE_DATA = 57, 3975d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // BLOCKED frame data is malformed. 3985d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_INVALID_BLOCKED_DATA = 58, 399a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // STOP_WAITING frame data is malformed. 400a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QUIC_INVALID_STOP_WAITING_DATA = 60, 4013551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // ACK frame data is malformed. 4023551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_ACK_DATA = 9, 4033551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) // CONGESTION_FEEDBACK frame data is malformed. 4043551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CONGESTION_FEEDBACK_DATA = 47, 4052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Version negotiation packet is malformed. 4063551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_VERSION_NEGOTIATION_PACKET = 10, 40790dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Public RST packet is malformed. 4083551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_PUBLIC_RST_PACKET = 11, 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error decrypting. 4103551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_DECRYPTION_FAILURE = 12, 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There was an error encrypting. 4123551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_ENCRYPTION_FAILURE = 13, 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The packet exceeded kMaxPacketSize. 4143551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PACKET_TOO_LARGE = 14, 4155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Data was sent for a stream which did not exist. 4163551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PACKET_FOR_NONEXISTENT_STREAM = 15, 4172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The peer is going away. May be a client or server. 4183551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PEER_GOING_AWAY = 16, 4195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A stream ID was invalid. 4203551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_STREAM_ID = 17, 421d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // A priority was invalid. 422d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) QUIC_INVALID_PRIORITY = 49, 4235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Too many streams already open. 4243551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_TOO_MANY_OPEN_STREAMS = 18, 4252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Received public reset for this connection. 4263551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PUBLIC_RESET = 19, 427b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // Invalid protocol version. 4283551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_VERSION = 20, 429a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 430a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // deprecated: QUIC_STREAM_RST_BEFORE_HEADERS_DECOMPRESSED = 21 431a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 432b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // The Header ID for a stream was too far from the previous. 4333551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_HEADER_ID = 22, 43490dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Negotiable parameter received during handshake had invalid value. 4353551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_NEGOTIATED_VALUE = 23, 43690dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // There was an error decompressing data. 4373551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_DECOMPRESSION_FAILURE = 24, 4385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We hit our prenegotiated (or default) timeout 4393551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CONNECTION_TIMED_OUT = 25, 44090dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // There was an error encountered migrating addresses 4413551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_ERROR_MIGRATING_ADDRESS = 26, 44258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // There was an error while writing to the socket. 4433551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PACKET_WRITE_ERROR = 27, 44458537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // There was an error while reading from the socket. 44558537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) QUIC_PACKET_READ_ERROR = 51, 446d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // We received a STREAM_FRAME with no data and no fin flag set. 447d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) QUIC_INVALID_STREAM_FRAME = 50, 4485d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // We received invalid data on the headers stream. 4495d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_INVALID_HEADERS_STREAM_DATA = 56, 4505d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // The peer violated the flow control protocol. 4515d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QUIC_FLOW_CONTROL_ERROR = 59, 4525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Crypto errors. 4545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 45590dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Hanshake failed. 4563551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_HANDSHAKE_FAILED = 28, 4575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Handshake message contained out of order tags. 4583551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_TAGS_OUT_OF_ORDER = 29, 4592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Handshake message contained too many entries. 4603551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_TOO_MANY_ENTRIES = 30, 4615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Handshake message contained an invalid value length. 4623551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_INVALID_VALUE_LENGTH = 31, 4635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A crypto message was received after the handshake was complete. 4643551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_AFTER_HANDSHAKE_COMPLETE = 32, 4652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with an illegal message tag. 4663551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CRYPTO_MESSAGE_TYPE = 33, 4672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with an illegal parameter. 4683551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_INVALID_CRYPTO_MESSAGE_PARAMETER = 34, 4694e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) // An invalid channel id signature was supplied. 4704e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) QUIC_INVALID_CHANNEL_ID_SIGNATURE = 52, 4712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with a mandatory parameter missing. 4723551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_PARAMETER_NOT_FOUND = 35, 4732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received with a parameter that has no overlap 4742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // with the local parameter. 4753551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_PARAMETER_NO_OVERLAP = 36, 4762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // A crypto message was received that contained a parameter with too few 4772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // values. 4783551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_MESSAGE_INDEX_NOT_FOUND = 37, 479c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // An internal error occured in crypto processing. 4803551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_INTERNAL_ERROR = 38, 481c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // A crypto handshake message specified an unsupported version. 4823551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_VERSION_NOT_SUPPORTED = 39, 483c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // There was no intersection between the crypto primitives supported by the 484c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // peer and ourselves. 4853551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_NO_SUPPORT = 40, 486c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // The server rejected our client hello messages too many times. 4873551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_TOO_MANY_REJECTS = 41, 488c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // The client rejected the server's certificate chain or signature. 4893551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_PROOF_INVALID = 42, 490c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // A crypto message was received with a duplicate tag. 4913551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_DUPLICATE_TAG = 43, 492b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // A crypto message was received with the wrong encryption level (i.e. it 493b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // should have been encrypted but was not.) 4943551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_ENCRYPTION_LEVEL_INCORRECT = 44, 495b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // The server config for a server has expired. 4963551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QUIC_CRYPTO_SERVER_CONFIG_EXPIRED = 45, 4974e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) // We failed to setup the symmetric keys for a connection. 4984e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) QUIC_CRYPTO_SYMMETRIC_KEY_SETUP_FAILED = 53, 499f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // A handshake message arrived, but we are still validating the 500f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // previous handshake message. 501f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QUIC_CRYPTO_MESSAGE_WHILE_VALIDATING_CLIENT_HELLO = 54, 502f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // This connection involved a version negotiation which appears to have been 503f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // tampered with. 504f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QUIC_VERSION_NEGOTIATION_MISMATCH = 55, 505c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 506c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // No error. Used as bound while iterating. 5075c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu QUIC_LAST_ERROR = 62, 5085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPacketPublicHeader { 5112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketPublicHeader(); 5122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit QuicPacketPublicHeader(const QuicPacketPublicHeader& other); 5132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~QuicPacketPublicHeader(); 5142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 515a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // Universal header. All QuicPacket headers will have a connection_id and 516a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // public flags. 517a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionId connection_id; 518a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length; 5192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool reset_flag; 5202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool version_flag; 521868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length; 522558790d6acca3451cf3a6b497803a5f07d0bec58Ben Murdoch QuicVersionVector versions; 5232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Header for Data or FEC packets. 526c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPacketHeader { 527c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QuicPacketHeader(); 528c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) explicit QuicPacketHeader(const QuicPacketPublicHeader& header); 5292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 5312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicPacketHeader& s); 5322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketPublicHeader public_header; 5342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool fec_flag; 5352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool entropy_flag; 5362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 5375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber packet_sequence_number; 538868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) InFecGroup is_in_fec_group; 5395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecGroupNumber fec_group; 5405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 5415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 542c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPublicResetPacket { 5435d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicPublicResetPacket(); 5445d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicPublicResetPacket(const QuicPacketPublicHeader& header); 5455d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 5462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketPublicHeader public_header; 5472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPublicResetNonceProof nonce_proof; 5485d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicPacketSequenceNumber rejected_sequence_number; 5495d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) IPEndPoint client_address; 5502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)enum QuicVersionNegotiationState { 5532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) START_NEGOTIATION = 0, 554ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // Server-side this implies we've sent a version negotiation packet and are 555ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // waiting on the client to select a compatible version. Client-side this 556ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // implies we've gotten a version negotiation packet, are retransmitting the 557ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // initial packets with a supported version and are waiting for our first 558ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // packet from the server. 559ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch NEGOTIATION_IN_PROGRESS, 560ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // This indicates this endpoint has received a packet from the peer with a 561ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // version this endpoint supports. Version negotiation is complete, and the 562ba5b9a6411cb1792fd21f0a078d7a25cd1ceec16Ben Murdoch // version number will no longer be sent with future packets. 5632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NEGOTIATED_VERSION 5642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef QuicPacketPublicHeader QuicVersionNegotiationPacket; 5672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// A padding frame contains no payload. 5692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicPaddingFrame { 5702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 5712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5720529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch// A ping frame contains no payload, though it is retransmittable, 5730529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch// and ACK'd just like other normal frames. 5740529e5d033099cbfc42635f6f6183833b09dff6eBen Murdochstruct NET_EXPORT_PRIVATE QuicPingFrame { 5750529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch}; 5760529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch 5775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicStreamFrame { 5785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame(); 579f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QuicStreamFrame(const QuicStreamFrame& frame); 5805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame(QuicStreamId stream_id, 5815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fin, 5822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamOffset offset, 583f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) IOVector data); 584f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 5855d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 5865d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicStreamFrame& s); 5875d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 588f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Returns a copy of the IOVector |data| as a heap-allocated string. 589f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Caller must take ownership of the returned string. 590f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) std::string* GetDataAsString() const; 5915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId stream_id; 5935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool fin; 5942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamOffset offset; // Location of this data in the stream. 595f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) IOVector data; 59658537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 59758537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // If this is set, then when this packet is ACKed the AckNotifier will be 59858537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // informed. 59958537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) QuicAckNotifier* notifier; 6005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// TODO(ianswett): Re-evaluate the trade-offs of hash_set vs set when framing 6032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// is finalized. 6042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef std::set<QuicPacketSequenceNumber> SequenceNumberSet; 6052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// TODO(pwestin): Add a way to enforce the max size of this map. 6062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef std::map<QuicPacketSequenceNumber, QuicTime> TimeMap; 6072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE ReceivedPacketInfo { 6095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ReceivedPacketInfo(); 6105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~ReceivedPacketInfo(); 6115d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 6122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 6132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const ReceivedPacketInfo& s); 6142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Entropy hash of all packets up to largest observed not including missing 6162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // packets. 6172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 6182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The highest packet sequence number we've observed from the peer. 6202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // 6212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // In general, this should be the largest packet number we've received. In 6222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // the case of truncated acks, we may have to advertise a lower "upper bound" 6232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // than largest received, to avoid implicitly acking missing packets that 6242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // don't fit in the missing packet list due to size limitations. In this 6252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // case, largest_observed may be a packet which is also in the missing packets 6262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // list. 6272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber largest_observed; 6282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Time elapsed since largest_observed was received until this Ack frame was 6302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // sent. 6312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicTime::Delta delta_time_largest_observed; 6322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // TODO(satyamshekhar): Can be optimized using an interval set like data 6342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // structure. 6355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The set of packets which we're expecting and have not received. 6362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) SequenceNumberSet missing_packets; 6370f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) 6380f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) // Whether the ack had to be truncated when sent. 6390f1bc08d4cfcc34181b0b5cbf065c40f687bf740Torne (Richard Coles) bool is_truncated; 6405d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 6415d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // Packets which have been revived via FEC. 6425d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // All of these must also be in missing_packets. 6435d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) SequenceNumberSet revived_packets; 6445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// True if the sequence number is greater than largest_observed or is listed 6472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// as missing. 6482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Always returns false for sequence numbers less than least_unacked. 6492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)bool NET_EXPORT_PRIVATE IsAwaitingPacket( 6502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const ReceivedPacketInfo& received_info, 6512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber sequence_number); 6522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Inserts missing packets between [lower, higher). 6542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void NET_EXPORT_PRIVATE InsertMissingPacketsBetween( 6552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ReceivedPacketInfo* received_info, 6562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber lower, 6572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber higher); 6582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 659a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicStopWaitingFrame { 660a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicStopWaitingFrame(); 661a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) ~QuicStopWaitingFrame(); 6625d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 6632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 664a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) std::ostream& os, const QuicStopWaitingFrame& s); 665a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 6662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Entropy hash of all packets up to, but not including, the least unacked 6672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // packet. 6682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 6695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The lowest packet we've sent which is unacked, and we expect an ack for. 6705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicPacketSequenceNumber least_unacked; 6712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 6722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicAckFrame { 6745d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicAckFrame(); 6752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 6772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicAckFrame& s); 6782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 679a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicStopWaitingFrame sent_info; 6802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ReceivedPacketInfo received_info; 6815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Defines for all types of congestion feedback that will be negotiated in QUIC, 6847dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch// kTCP MUST be supported by all QUIC implementations to guarantee 100% 6855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// compatibility. 6865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum CongestionFeedbackType { 6875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kTCP, // Used to mimic TCP. 6885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kInterArrival, // Use additional inter arrival information. 6895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) kFixRate, // Provided for testing. 6905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 6915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 692e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdochenum LossDetectionType { 693e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch kNack, // Used to mimic TCP's loss detection. 694e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch kTime, // Time based loss detection. 695e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch}; 696e5d81f57cb97b3b6b7fccc9c5610d21eb81db09dBen Murdoch 6975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageTCP { 6985d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) CongestionFeedbackMessageTCP(); 6995d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicByteCount receive_window; 7015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageInterArrival { 7042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageInterArrival(); 7052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~CongestionFeedbackMessageInterArrival(); 7065d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The set of received packets since the last feedback was sent, along with 7082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // their arrival times. 7092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) TimeMap received_packet_times; 7105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE CongestionFeedbackMessageFixRate { 7132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageFixRate(); 7142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicBandwidth bitrate; 7155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicCongestionFeedbackFrame { 7182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicCongestionFeedbackFrame(); 7192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~QuicCongestionFeedbackFrame(); 7205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 7222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicCongestionFeedbackFrame& c); 7235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackType type; 7252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // This should really be a union, but since the inter arrival struct 7262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // is non-trivial, C++ prohibits it. 7272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageTCP tcp; 7282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageInterArrival inter_arrival; 7292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CongestionFeedbackMessageFixRate fix_rate; 7305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicRstStreamFrame { 7335d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicRstStreamFrame(); 7345d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicRstStreamFrame(QuicStreamId stream_id, 7355d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicRstStreamErrorCode error_code, 7365d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicStreamOffset bytes_written); 7375d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7385d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 7395d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicRstStreamFrame& r); 7405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamId stream_id; 742c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) QuicRstStreamErrorCode error_code; 7435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string error_details; 7445d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7455d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // Used to update flow control windows. On termination of a stream, both 7465d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // endpoints must inform the peer of the number of bytes they have sent on 7475d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // that stream. This can be done through normal termination (data packet with 7485d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // FIN) or through a RST. 7495d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicStreamOffset byte_offset; 7505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicConnectionCloseFrame { 7535d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicConnectionCloseFrame(); 7545d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7555d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 7565d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicConnectionCloseFrame& c); 7575d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicErrorCode error_code; 7595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string error_details; 7602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 7612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 7622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE QuicGoAwayFrame { 7635d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicGoAwayFrame(); 7642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicGoAwayFrame(QuicErrorCode error_code, 7652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamId last_good_stream_id, 7662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::string& reason); 7672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 7685d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 7695d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicGoAwayFrame& g); 7705d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicErrorCode error_code; 7722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicStreamId last_good_stream_id; 7732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::string reason_phrase; 7745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 7755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7765d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// Flow control updates per-stream and at the connection levoel. 7775d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// Based on SPDY's WINDOW_UPDATE frame, but uses an absolute byte offset rather 7785d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// than a window delta. 7795d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// TODO(rjshade): A possible future optimization is to make stream_id and 7805d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// byte_offset variable length, similar to stream frames. 7815d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicWindowUpdateFrame { 7825d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicWindowUpdateFrame() {} 7835d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicWindowUpdateFrame(QuicStreamId stream_id, QuicStreamOffset byte_offset); 7845d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7855d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 7865d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicWindowUpdateFrame& w); 7875d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7885d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // The stream this frame applies to. 0 is a special case meaning the overall 7895d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // connection rather than a specific stream. 7905d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicStreamId stream_id; 7915d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7925d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // Byte offset in the stream or connection. The receiver of this frame must 7935d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // not send data which would result in this offset being exceeded. 7945d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicStreamOffset byte_offset; 7955d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)}; 7965d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 7975d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// The BLOCKED frame is used to indicate to the remote endpoint that this 7985d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// endpoint believes itself to be flow-control blocked but otherwise ready to 7995d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// send data. The BLOCKED frame is purely advisory and optional. 8005d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// Based on SPDY's BLOCKED frame (undocumented as of 2014-01-28). 8015d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicBlockedFrame { 8025d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicBlockedFrame() {} 8035d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicBlockedFrame(QuicStreamId stream_id); 8045d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 8055d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 8065d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicBlockedFrame& b); 8075d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 8085d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // The stream this frame applies to. 0 is a special case meaning the overall 8095d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // connection rather than a specific stream. 8105d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicStreamId stream_id; 8115d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)}; 8125d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 813c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// EncryptionLevel enumerates the stages of encryption that a QUIC connection 814c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// progresses through. When retransmitting a packet, the encryption level needs 815c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// to be specified so that it is retransmitted at a level which the peer can 816c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)// understand. 817c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)enum EncryptionLevel { 818c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) ENCRYPTION_NONE = 0, 819c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) ENCRYPTION_INITIAL = 1, 820c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) ENCRYPTION_FORWARD_SECURE = 2, 821c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 822c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) NUM_ENCRYPTION_LEVELS, 823c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 824c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 8255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicFrame { 8265d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicFrame(); 8275d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicPaddingFrame* padding_frame); 8285d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicStreamFrame* stream_frame); 8295d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicAckFrame* frame); 8305d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicCongestionFeedbackFrame* frame); 8315d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicRstStreamFrame* frame); 8325d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicConnectionCloseFrame* frame); 833a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) explicit QuicFrame(QuicStopWaitingFrame* frame); 8340529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch explicit QuicFrame(QuicPingFrame* frame); 8355d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicGoAwayFrame* frame); 8365d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicWindowUpdateFrame* frame); 8375d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) explicit QuicFrame(QuicBlockedFrame* frame); 8385d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 8395d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 8405d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) std::ostream& os, const QuicFrame& frame); 8415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFrameType type; 8435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 8442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPaddingFrame* padding_frame; 8455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicStreamFrame* stream_frame; 8465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicAckFrame* ack_frame; 8472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicCongestionFeedbackFrame* congestion_feedback_frame; 848a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicStopWaitingFrame* stop_waiting_frame; 8490529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch QuicPingFrame* ping_frame; 8505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicRstStreamFrame* rst_stream_frame; 8515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicConnectionCloseFrame* connection_close_frame; 8522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicGoAwayFrame* goaway_frame; 8535d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicWindowUpdateFrame* window_update_frame; 8545d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicBlockedFrame* blocked_frame; 8555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 8565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 8575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef std::vector<QuicFrame> QuicFrames; 8595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicFecData { 8615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecData(); 8625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The FEC group number is also the sequence number of the first 8642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // FEC protected packet. The last protected packet's sequence number will 8652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // be one less than the sequence number of the FEC packet. 8665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QuicFecGroupNumber fec_group; 8675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece redundancy; 8685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 8695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicData { 8715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 8725d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicData(const char* buffer, size_t length); 8735d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicData(char* buffer, size_t length, bool owns_buffer); 8745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~QuicData(); 8755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::StringPiece AsStringPiece() const { 8775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return base::StringPiece(data(), length()); 8785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 8795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* data() const { return buffer_; } 8815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length() const { return length_; } 8825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 8845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* buffer_; 8855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t length_; 8865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool owns_buffer_; 8875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicData); 8895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 8905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicPacket : public QuicData { 8925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 893868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) static QuicPacket* NewDataPacket( 894868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) char* buffer, 895868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) size_t length, 896868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool owns_buffer, 897a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length, 898868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool includes_version, 899868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length) { 900a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) return new QuicPacket(buffer, length, owns_buffer, connection_id_length, 901868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) includes_version, sequence_number_length, false); 9025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 904868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) static QuicPacket* NewFecPacket( 905868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) char* buffer, 906868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) size_t length, 907868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool owns_buffer, 908a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length, 909868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) bool includes_version, 910868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length) { 911a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) return new QuicPacket(buffer, length, owns_buffer, connection_id_length, 912868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) includes_version, sequence_number_length, true); 9135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece FecProtectedData() const; 9162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece AssociatedData() const; 9172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece BeforePlaintext() const; 9182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::StringPiece Plaintext() const; 9195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool is_fec_packet() const { return is_fec_packet_; } 9212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* mutable_data() { return buffer_; } 9235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 9252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacket(char* buffer, 9262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) size_t length, 9272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool owns_buffer, 928a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) QuicConnectionIdLength connection_id_length, 9292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool includes_version, 930868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 9315d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) bool is_fec_packet); 9322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char* buffer_; 9342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const bool is_fec_packet_; 935a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) const QuicConnectionIdLength connection_id_length_; 9362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const bool includes_version_; 937868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles) const QuicSequenceNumberLength sequence_number_length_; 9385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicPacket); 9405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 9415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NET_EXPORT_PRIVATE QuicEncryptedPacket : public QuicData { 9435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 9445d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicEncryptedPacket(const char* buffer, size_t length); 9455d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicEncryptedPacket(char* buffer, size_t length, bool owns_buffer); 9465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 947f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Clones the packet into a new packet which owns the buffer. 948f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) QuicEncryptedPacket* Clone() const; 949f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 9502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // By default, gtest prints the raw bytes of an object. The bool data 9512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // member (in the base class QuicData) causes this object to have padding 9522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // bytes, which causes the default gtest object printer to read 9532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // uninitialize memory. So we need to teach gtest how to print this object. 9542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 9552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicEncryptedPacket& s); 9565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 9585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(QuicEncryptedPacket); 9595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 9605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class NET_EXPORT_PRIVATE RetransmittableFrames { 9622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public: 9632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) RetransmittableFrames(); 9642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ~RetransmittableFrames(); 9652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9662a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Allocates a local copy of the referenced StringPiece has QuicStreamFrame 9672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // use it. 9682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Takes ownership of |stream_frame|. 9692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const QuicFrame& AddStreamFrame(QuicStreamFrame* stream_frame); 9702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Takes ownership of the frame inside |frame|. 9712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const QuicFrame& AddNonStreamFrame(const QuicFrame& frame); 9722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const QuicFrames& frames() const { return frames_; } 9732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9745d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) IsHandshake HasCryptoHandshake() const; 9755d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 976c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) void set_encryption_level(EncryptionLevel level); 977c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) EncryptionLevel encryption_level() const { 978c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) return encryption_level_; 979c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) } 980c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 9812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) private: 9822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicFrames frames_; 983c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) EncryptionLevel encryption_level_; 9842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Data referenced by the StringPiece of a QuicStreamFrame. 9852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::vector<std::string*> stream_data_; 9862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(RetransmittableFrames); 9882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 9892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct NET_EXPORT_PRIVATE SerializedPacket { 9912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) SerializedPacket(QuicPacketSequenceNumber sequence_number, 9923551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length, 9932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacket* packet, 9942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash, 99558537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) RetransmittableFrames* retransmittable_frames); 99658537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) ~SerializedPacket(); 9972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 9982a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketSequenceNumber sequence_number; 9993551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) QuicSequenceNumberLength sequence_number_length; 10002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacket* packet; 10012a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) QuicPacketEntropyHash entropy_hash; 10022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) RetransmittableFrames* retransmittable_frames; 100358537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 100458537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // If set, these will be called when this packet is ACKed by the peer. 100558537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) std::set<QuicAckNotifier*> notifiers; 10062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 10072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 10082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// A struct for functions which consume data payloads and fins. 10095d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)struct NET_EXPORT_PRIVATE QuicConsumedData { 10105d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) QuicConsumedData(size_t bytes_consumed, bool fin_consumed); 10115d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 10122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // By default, gtest prints the raw bytes of an object. The bool data 10132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // member causes this object to have padding bytes, which causes the 10142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // default gtest object printer to read uninitialize memory. So we need 10152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // to teach gtest how to print this object. 10162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) NET_EXPORT_PRIVATE friend std::ostream& operator<<( 10172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) std::ostream& os, const QuicConsumedData& s); 10182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 101958537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // How many bytes were consumed. 10202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) size_t bytes_consumed; 102158537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) 102258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles) // True if an incoming fin was consumed. 10232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool fin_consumed; 10242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 10252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 10264e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)enum WriteStatus { 10274e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WRITE_STATUS_OK, 10284e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WRITE_STATUS_BLOCKED, 10294e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WRITE_STATUS_ERROR, 10304e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)}; 10314e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 10324e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)// A struct used to return the result of write calls including either the number 10334e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)// of bytes written or the error code, depending upon the status. 10344e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)struct NET_EXPORT_PRIVATE WriteResult { 10355d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) WriteResult(WriteStatus status, int bytes_written_or_error_code); 10360529e5d033099cbfc42635f6f6183833b09dff6eBen Murdoch WriteResult(); 10374e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 10384e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) WriteStatus status; 10394e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) union { 10404e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) int bytes_written; // only valid when status is OK 10414e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) int error_code; // only valid when status is ERROR 10424e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) }; 10434e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)}; 10444e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 10455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace net 10465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // NET_QUIC_QUIC_PROTOCOL_H_ 1048