blob: cc02882ddc932598035b1e461545fe2816fa4697 [file] [log] [blame]
[email protected]8b37a092012-10-18 21:53:491// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#include "net/quic/quic_framer.h"
6
[email protected]14c1c232013-06-11 17:52:447#include "base/containers/hash_tables.h"
[email protected]8b37a092012-10-18 21:53:498#include "net/quic/crypto/quic_decrypter.h"
9#include "net/quic/crypto/quic_encrypter.h"
10#include "net/quic/quic_data_reader.h"
11#include "net/quic/quic_data_writer.h"
[email protected]8b37a092012-10-18 21:53:4912
[email protected]8b37a092012-10-18 21:53:4913using base::StringPiece;
[email protected]c995c572013-01-18 05:43:2014using std::make_pair;
[email protected]a674b4c2012-12-05 03:44:3015using std::map;
[email protected]8e01c062013-10-31 07:35:3116using std::max;
17using std::min;
[email protected]e537f742012-12-07 15:33:5318using std::numeric_limits;
[email protected]fee17f72013-02-03 07:47:4119using std::string;
[email protected]8b37a092012-10-18 21:53:4920
21namespace net {
22
[email protected]c995c572013-01-18 05:43:2023namespace {
24
25// Mask to select the lowest 48 bits of a sequence number.
[email protected]25c31dc2013-06-05 17:56:0426const QuicPacketSequenceNumber k6ByteSequenceNumberMask =
[email protected]c995c572013-01-18 05:43:2027 GG_UINT64_C(0x0000FFFFFFFFFFFF);
[email protected]25c31dc2013-06-05 17:56:0428const QuicPacketSequenceNumber k4ByteSequenceNumberMask =
29 GG_UINT64_C(0x00000000FFFFFFFF);
30const QuicPacketSequenceNumber k2ByteSequenceNumberMask =
31 GG_UINT64_C(0x000000000000FFFF);
32const QuicPacketSequenceNumber k1ByteSequenceNumberMask =
33 GG_UINT64_C(0x00000000000000FF);
[email protected]c995c572013-01-18 05:43:2034
[email protected]b064310782013-05-30 21:12:1735const QuicGuid k1ByteGuidMask = GG_UINT64_C(0x00000000000000FF);
36const QuicGuid k4ByteGuidMask = GG_UINT64_C(0x00000000FFFFFFFF);
37
[email protected]8e01c062013-10-31 07:35:3138// Number of bits the sequence number length bits are shifted from the right
39// edge of the public header.
40const uint8 kPublicHeaderSequenceNumberShift = 4;
41
[email protected]97cf3022013-09-05 14:30:1642// New Frame Types, QUIC v. >= 10:
43// There are two interpretations for the Frame Type byte in the QUIC protocol,
44// resulting in two Frame Types: Special Frame Types and Regular Frame Types.
45//
46// Regular Frame Types use the Frame Type byte simply. Currently defined
47// Regular Frame Types are:
48// Padding : 0b 00000000 (0x00)
49// ResetStream : 0b 00000001 (0x01)
50// ConnectionClose : 0b 00000010 (0x02)
51// GoAway : 0b 00000011 (0x03)
52//
53// Special Frame Types encode both a Frame Type and corresponding flags
54// all in the Frame Type byte. Currently defined Special Frame Types are:
55// Stream : 0b 1xxxxxxx
56// Ack : 0b 01xxxxxx
57// CongestionFeedback : 0b 001xxxxx
58//
59// Semantics of the flag bits above (the x bits) depends on the frame type.
60
61// Masks to determine if the frame type is a special use
62// and for specific special frame types.
63const uint8 kQuicFrameTypeSpecialMask = 0xE0; // 0b 11100000
64const uint8 kQuicFrameTypeStreamMask = 0x80;
65const uint8 kQuicFrameTypeAckMask = 0x40;
66const uint8 kQuicFrameTypeCongestionFeedbackMask = 0x20;
67
[email protected]3e60db82013-08-05 19:43:0668// Stream frame relative shifts and masks for interpreting the stream flags.
69// StreamID may be 1, 2, 3, or 4 bytes.
70const uint8 kQuicStreamIdShift = 2;
71const uint8 kQuicStreamIDLengthMask = 0x03;
72
73// Offset may be 0, 2, 3, 4, 5, 6, 7, 8 bytes.
74const uint8 kQuicStreamOffsetShift = 3;
75const uint8 kQuicStreamOffsetMask = 0x07;
76
77// Data length may be 0 or 2 bytes.
78const uint8 kQuicStreamDataLengthShift = 1;
79const uint8 kQuicStreamDataLengthMask = 0x01;
80
81// Fin bit may be set or not.
82const uint8 kQuicStreamFinShift = 1;
83const uint8 kQuicStreamFinMask = 0x01;
84
[email protected]8e01c062013-10-31 07:35:3185// Sequence number size shift used in AckFrames.
86const uint8 kQuicSequenceNumberLengthShift = 2;
87
88// Acks may be truncated.
89const uint8 kQuicAckTruncatedShift = 1;
90const uint8 kQuicAckTruncatedMask = 0x01;
91
92// Acks may not have any nacks.
93const uint8 kQuicHasNacksMask = 0x01;
[email protected]3e60db82013-08-05 19:43:0694
[email protected]c995c572013-01-18 05:43:2095// Returns the absolute value of the difference between |a| and |b|.
96QuicPacketSequenceNumber Delta(QuicPacketSequenceNumber a,
97 QuicPacketSequenceNumber b) {
98 // Since these are unsigned numbers, we can't just return abs(a - b)
99 if (a < b) {
100 return b - a;
101 }
102 return a - b;
103}
104
105QuicPacketSequenceNumber ClosestTo(QuicPacketSequenceNumber target,
106 QuicPacketSequenceNumber a,
107 QuicPacketSequenceNumber b) {
108 return (Delta(target, a) < Delta(target, b)) ? a : b;
109}
110
111} // namespace
[email protected]610a7e942012-12-18 00:21:39112
[email protected]b007e632013-10-28 08:39:25113QuicFramer::QuicFramer(const QuicVersionVector& supported_versions,
[email protected]74bda142013-03-31 02:49:11114 QuicTime creation_time,
[email protected]14e8106c2013-03-14 16:25:33115 bool is_server)
[email protected]8b37a092012-10-18 21:53:49116 : visitor_(NULL),
117 fec_builder_(NULL),
[email protected]8e01c062013-10-31 07:35:31118 entropy_calculator_(NULL),
[email protected]8b37a092012-10-18 21:53:49119 error_(QUIC_NO_ERROR),
[email protected]c995c572013-01-18 05:43:20120 last_sequence_number_(0),
[email protected]b064310782013-05-30 21:12:17121 last_serialized_guid_(0),
[email protected]b007e632013-10-28 08:39:25122 supported_versions_(supported_versions),
[email protected]2532de12013-05-09 12:29:33123 alternative_decrypter_latch_(false),
[email protected]74bda142013-03-31 02:49:11124 is_server_(is_server),
125 creation_time_(creation_time) {
[email protected]b007e632013-10-28 08:39:25126 DCHECK(!supported_versions.empty());
127 quic_version_ = supported_versions_[0];
[email protected]5dafdb62013-11-14 01:24:26128 decrypter_.reset(QuicDecrypter::Create(kNULL));
[email protected]b007e632013-10-28 08:39:25129 encrypter_[ENCRYPTION_NONE].reset(
[email protected]5dafdb62013-11-14 01:24:26130 QuicEncrypter::Create(kNULL));
[email protected]8b37a092012-10-18 21:53:49131}
132
133QuicFramer::~QuicFramer() {}
134
[email protected]5351cc4b2013-03-03 07:22:41135// static
[email protected]3e60db82013-08-05 19:43:06136size_t QuicFramer::GetMinStreamFrameSize(QuicVersion version,
137 QuicStreamId stream_id,
[email protected]f62262b2013-07-05 20:57:30138 QuicStreamOffset offset,
[email protected]3e60db82013-08-05 19:43:06139 bool last_frame_in_packet) {
[email protected]f62262b2013-07-05 20:57:30140 return kQuicFrameTypeSize + GetStreamIdSize(stream_id) +
[email protected]3e60db82013-08-05 19:43:06141 GetStreamOffsetSize(offset) +
142 (last_frame_in_packet ? 0 : kQuicStreamPayloadLengthSize);
[email protected]f62262b2013-07-05 20:57:30143}
144
145// static
[email protected]8e01c062013-10-31 07:35:31146size_t QuicFramer::GetMinAckFrameSize(
147 QuicVersion version,
148 QuicSequenceNumberLength sequence_number_length,
149 QuicSequenceNumberLength largest_observed_length) {
[email protected]31ae854842013-11-27 00:05:46150 return kQuicFrameTypeSize + kQuicEntropyHashSize +
151 sequence_number_length + kQuicEntropyHashSize +
152 largest_observed_length + kQuicDeltaTimeLargestObservedSize;
[email protected]8e01c062013-10-31 07:35:31153}
154
155// static
[email protected]5351cc4b2013-03-03 07:22:41156size_t QuicFramer::GetMinRstStreamFrameSize() {
[email protected]3e60db82013-08-05 19:43:06157 return kQuicFrameTypeSize + kQuicMaxStreamIdSize + kQuicErrorCodeSize +
[email protected]5351cc4b2013-03-03 07:22:41158 kQuicErrorDetailsLengthSize;
159}
160
161// static
162size_t QuicFramer::GetMinConnectionCloseFrameSize() {
[email protected]8e01c062013-10-31 07:35:31163 return kQuicFrameTypeSize + kQuicErrorCodeSize + kQuicErrorDetailsLengthSize;
[email protected]5351cc4b2013-03-03 07:22:41164}
165
166// static
167size_t QuicFramer::GetMinGoAwayFrameSize() {
168 return kQuicFrameTypeSize + kQuicErrorCodeSize + kQuicErrorDetailsLengthSize +
[email protected]3e60db82013-08-05 19:43:06169 kQuicMaxStreamIdSize;
[email protected]5351cc4b2013-03-03 07:22:41170}
171
[email protected]899951652013-05-16 12:52:39172// static
[email protected]f62262b2013-07-05 20:57:30173size_t QuicFramer::GetStreamIdSize(QuicStreamId stream_id) {
[email protected]3e60db82013-08-05 19:43:06174 // Sizes are 1 through 4 bytes.
175 for (int i = 1; i <= 4; ++i) {
176 stream_id >>= 8;
177 if (stream_id == 0) {
178 return i;
179 }
180 }
181 LOG(DFATAL) << "Failed to determine StreamIDSize.";
[email protected]f62262b2013-07-05 20:57:30182 return 4;
183}
184
185// static
186size_t QuicFramer::GetStreamOffsetSize(QuicStreamOffset offset) {
[email protected]3e60db82013-08-05 19:43:06187 // 0 is a special case.
188 if (offset == 0) {
189 return 0;
190 }
191 // 2 through 8 are the remaining sizes.
192 offset >>= 8;
193 for (int i = 2; i <= 8; ++i) {
194 offset >>= 8;
195 if (offset == 0) {
196 return i;
197 }
198 }
199 LOG(DFATAL) << "Failed to determine StreamOffsetSize.";
[email protected]f62262b2013-07-05 20:57:30200 return 8;
201}
202
[email protected]3e60db82013-08-05 19:43:06203// static
204size_t QuicFramer::GetVersionNegotiationPacketSize(size_t number_versions) {
205 return kPublicFlagsSize + PACKET_8BYTE_GUID +
206 number_versions * kQuicVersionSize;
207}
208
209// static
[email protected]8e01c062013-10-31 07:35:31210bool QuicFramer::CanTruncate(
211 QuicVersion version, const QuicFrame& frame, size_t free_bytes) {
[email protected]3e60db82013-08-05 19:43:06212 if ((frame.type == ACK_FRAME || frame.type == CONNECTION_CLOSE_FRAME) &&
[email protected]8e01c062013-10-31 07:35:31213 free_bytes >= GetMinAckFrameSize(version,
214 PACKET_6BYTE_SEQUENCE_NUMBER,
215 PACKET_6BYTE_SEQUENCE_NUMBER)) {
[email protected]3e60db82013-08-05 19:43:06216 return true;
217 }
218 return false;
219}
220
[email protected]48878092013-07-26 14:51:56221bool QuicFramer::IsSupportedVersion(const QuicVersion version) const {
[email protected]b007e632013-10-28 08:39:25222 for (size_t i = 0; i < supported_versions_.size(); ++i) {
223 if (version == supported_versions_[i]) {
[email protected]48878092013-07-26 14:51:56224 return true;
225 }
226 }
227 return false;
[email protected]14e8106c2013-03-14 16:25:33228}
229
[email protected]8e01c062013-10-31 07:35:31230size_t QuicFramer::GetSerializedFrameLength(
231 const QuicFrame& frame,
232 size_t free_bytes,
233 bool first_frame,
234 bool last_frame,
235 QuicSequenceNumberLength sequence_number_length) {
[email protected]fee17f72013-02-03 07:47:41236 if (frame.type == PADDING_FRAME) {
237 // PADDING implies end of packet.
238 return free_bytes;
239 }
[email protected]8e01c062013-10-31 07:35:31240 size_t frame_len =
241 ComputeFrameLength(frame, last_frame, sequence_number_length);
[email protected]fee17f72013-02-03 07:47:41242 if (frame_len > free_bytes) {
243 // Only truncate the first frame in a packet, so if subsequent ones go
244 // over, stop including more frames.
245 if (!first_frame) {
246 return 0;
247 }
[email protected]8e01c062013-10-31 07:35:31248 if (CanTruncate(quic_version_, frame, free_bytes)) {
[email protected]fee17f72013-02-03 07:47:41249 // Truncate the frame so the packet will not exceed kMaxPacketSize.
250 // Note that we may not use every byte of the writer in this case.
[email protected]3e5fed12013-11-22 22:21:41251 DVLOG(1) << "Truncating large frame";
[email protected]3e60db82013-08-05 19:43:06252 return free_bytes;
[email protected]fee17f72013-02-03 07:47:41253 }
254 }
255 return frame_len;
[email protected]dda3e9b2012-12-22 21:49:25256}
257
[email protected]8e01c062013-10-31 07:35:31258QuicFramer::AckFrameInfo::AckFrameInfo() : max_delta(0) { }
259
260QuicFramer::AckFrameInfo::~AckFrameInfo() { }
261
[email protected]9db443912013-02-25 05:27:03262QuicPacketEntropyHash QuicFramer::GetPacketEntropyHash(
263 const QuicPacketHeader& header) const {
[email protected]457d6952013-12-13 09:24:58264 return header.entropy_flag << (header.packet_sequence_number % 8);
[email protected]9db443912013-02-25 05:27:03265}
266
[email protected]8e01c062013-10-31 07:35:31267// Test only.
[email protected]3e60db82013-08-05 19:43:06268SerializedPacket QuicFramer::BuildUnsizedDataPacket(
[email protected]9db443912013-02-25 05:27:03269 const QuicPacketHeader& header,
270 const QuicFrames& frames) {
[email protected]dda3e9b2012-12-22 21:49:25271 const size_t max_plaintext_size = GetMaxPlaintextSize(kMaxPacketSize);
[email protected]b064310782013-05-30 21:12:17272 size_t packet_size = GetPacketHeaderSize(header);
[email protected]dda3e9b2012-12-22 21:49:25273 for (size_t i = 0; i < frames.size(); ++i) {
[email protected]fee17f72013-02-03 07:47:41274 DCHECK_LE(packet_size, max_plaintext_size);
[email protected]583bcbcf2013-10-28 01:51:15275 bool first_frame = i == 0;
276 bool last_frame = i == frames.size() - 1;
[email protected]fee17f72013-02-03 07:47:41277 const size_t frame_size = GetSerializedFrameLength(
[email protected]8e01c062013-10-31 07:35:31278 frames[i], max_plaintext_size - packet_size, first_frame, last_frame,
279 header.public_header.sequence_number_length);
[email protected]fee17f72013-02-03 07:47:41280 DCHECK(frame_size);
281 packet_size += frame_size;
[email protected]610a7e942012-12-18 00:21:39282 }
[email protected]3e60db82013-08-05 19:43:06283 return BuildDataPacket(header, frames, packet_size);
[email protected]fee17f72013-02-03 07:47:41284}
[email protected]610a7e942012-12-18 00:21:39285
[email protected]3e60db82013-08-05 19:43:06286SerializedPacket QuicFramer::BuildDataPacket(
[email protected]9db443912013-02-25 05:27:03287 const QuicPacketHeader& header,
288 const QuicFrames& frames,
289 size_t packet_size) {
[email protected]fee17f72013-02-03 07:47:41290 QuicDataWriter writer(packet_size);
[email protected]ea825e02013-08-21 18:12:45291 const SerializedPacket kNoPacket(
292 0, PACKET_1BYTE_SEQUENCE_NUMBER, NULL, 0, NULL);
[email protected]8e01c062013-10-31 07:35:31293 if (!AppendPacketHeader(header, &writer)) {
[email protected]9db443912013-02-25 05:27:03294 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49295 }
296
[email protected]fee17f72013-02-03 07:47:41297 for (size_t i = 0; i < frames.size(); ++i) {
[email protected]be24ab22012-10-22 03:01:52298 const QuicFrame& frame = frames[i];
[email protected]f62262b2013-07-05 20:57:30299
[email protected]3e60db82013-08-05 19:43:06300 const bool last_frame_in_packet = i == (frames.size() - 1);
301 if (!AppendTypeByte(frame, last_frame_in_packet, &writer)) {
[email protected]9db443912013-02-25 05:27:03302 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49303 }
304
[email protected]be24ab22012-10-22 03:01:52305 switch (frame.type) {
[email protected]c995c572013-01-18 05:43:20306 case PADDING_FRAME:
307 writer.WritePadding();
308 break;
[email protected]be24ab22012-10-22 03:01:52309 case STREAM_FRAME:
[email protected]ea2ab47b2013-08-13 00:44:11310 if (!AppendStreamFramePayload(
311 *frame.stream_frame, last_frame_in_packet, &writer)) {
312 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49313 }
314 break;
[email protected]be24ab22012-10-22 03:01:52315 case ACK_FRAME:
[email protected]31ae854842013-11-27 00:05:46316 if (!AppendAckFramePayloadAndTypeByte(
317 header, *frame.ack_frame, &writer)) {
318 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49319 }
320 break;
[email protected]26f3f8e2012-12-13 21:07:19321 case CONGESTION_FEEDBACK_FRAME:
322 if (!AppendQuicCongestionFeedbackFramePayload(
323 *frame.congestion_feedback_frame, &writer)) {
[email protected]9db443912013-02-25 05:27:03324 return kNoPacket;
[email protected]26f3f8e2012-12-13 21:07:19325 }
326 break;
[email protected]be24ab22012-10-22 03:01:52327 case RST_STREAM_FRAME:
[email protected]86a318d2013-01-23 21:16:04328 if (!AppendRstStreamFramePayload(*frame.rst_stream_frame, &writer)) {
[email protected]9db443912013-02-25 05:27:03329 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49330 }
331 break;
[email protected]be24ab22012-10-22 03:01:52332 case CONNECTION_CLOSE_FRAME:
333 if (!AppendConnectionCloseFramePayload(
[email protected]7759f852013-01-25 15:51:05334 *frame.connection_close_frame, &writer)) {
[email protected]9db443912013-02-25 05:27:03335 return kNoPacket;
336 }
337 break;
338 case GOAWAY_FRAME:
339 if (!AppendGoAwayFramePayload(*frame.goaway_frame, &writer)) {
340 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49341 }
342 break;
343 default:
[email protected]610a7e942012-12-18 00:21:39344 RaiseError(QUIC_INVALID_FRAME_DATA);
[email protected]9db443912013-02-25 05:27:03345 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49346 }
347 }
[email protected]082b65b2012-11-10 19:11:31348
[email protected]86a318d2013-01-23 21:16:04349 // Save the length before writing, because take clears it.
[email protected]fee17f72013-02-03 07:47:41350 const size_t len = writer.length();
351 // Less than or equal because truncated acks end up with max_plaintex_size
352 // length, even though they're typically slightly shorter.
353 DCHECK_LE(len, packet_size);
[email protected]5351cc4b2013-03-03 07:22:41354 QuicPacket* packet = QuicPacket::NewDataPacket(
[email protected]b064310782013-05-30 21:12:17355 writer.take(), len, true, header.public_header.guid_length,
[email protected]25c31dc2013-06-05 17:56:04356 header.public_header.version_flag,
357 header.public_header.sequence_number_length);
[email protected]c995c572013-01-18 05:43:20358
[email protected]8b37a092012-10-18 21:53:49359 if (fec_builder_) {
360 fec_builder_->OnBuiltFecProtectedPayload(header,
[email protected]610a7e942012-12-18 00:21:39361 packet->FecProtectedData());
[email protected]8b37a092012-10-18 21:53:49362 }
363
[email protected]ea825e02013-08-21 18:12:45364 return SerializedPacket(header.packet_sequence_number,
365 header.public_header.sequence_number_length, packet,
[email protected]9db443912013-02-25 05:27:03366 GetPacketEntropyHash(header), NULL);
[email protected]8b37a092012-10-18 21:53:49367}
368
[email protected]3e60db82013-08-05 19:43:06369SerializedPacket QuicFramer::BuildFecPacket(const QuicPacketHeader& header,
370 const QuicFecData& fec) {
[email protected]b064310782013-05-30 21:12:17371 DCHECK_EQ(IN_FEC_GROUP, header.is_in_fec_group);
372 DCHECK_NE(0u, header.fec_group);
373 size_t len = GetPacketHeaderSize(header);
[email protected]8b37a092012-10-18 21:53:49374 len += fec.redundancy.length();
375
376 QuicDataWriter writer(len);
[email protected]ea825e02013-08-21 18:12:45377 const SerializedPacket kNoPacket(
378 0, PACKET_1BYTE_SEQUENCE_NUMBER, NULL, 0, NULL);
[email protected]8e01c062013-10-31 07:35:31379 if (!AppendPacketHeader(header, &writer)) {
[email protected]9db443912013-02-25 05:27:03380 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49381 }
382
[email protected]8b37a092012-10-18 21:53:49383 if (!writer.WriteBytes(fec.redundancy.data(), fec.redundancy.length())) {
[email protected]9db443912013-02-25 05:27:03384 return kNoPacket;
[email protected]8b37a092012-10-18 21:53:49385 }
386
[email protected]b064310782013-05-30 21:12:17387 return SerializedPacket(
388 header.packet_sequence_number,
[email protected]ea825e02013-08-21 18:12:45389 header.public_header.sequence_number_length,
[email protected]b064310782013-05-30 21:12:17390 QuicPacket::NewFecPacket(writer.take(), len, true,
391 header.public_header.guid_length,
[email protected]25c31dc2013-06-05 17:56:04392 header.public_header.version_flag,
393 header.public_header.sequence_number_length),
[email protected]b064310782013-05-30 21:12:17394 GetPacketEntropyHash(header), NULL);
[email protected]8b37a092012-10-18 21:53:49395}
396
[email protected]86a318d2013-01-23 21:16:04397// static
[email protected]3e60db82013-08-05 19:43:06398QuicEncryptedPacket* QuicFramer::BuildPublicResetPacket(
[email protected]86a318d2013-01-23 21:16:04399 const QuicPublicResetPacket& packet) {
[email protected]9db443912013-02-25 05:27:03400 DCHECK(packet.public_header.reset_flag);
[email protected]5351cc4b2013-03-03 07:22:41401 size_t len = GetPublicResetPacketSize();
[email protected]86a318d2013-01-23 21:16:04402 QuicDataWriter writer(len);
403
[email protected]1354bf62013-05-23 23:17:18404 uint8 flags = static_cast<uint8>(PACKET_PUBLIC_FLAGS_RST |
[email protected]25c31dc2013-06-05 17:56:04405 PACKET_PUBLIC_FLAGS_8BYTE_GUID |
406 PACKET_PUBLIC_FLAGS_6BYTE_SEQUENCE);
[email protected]0bbeb6972013-05-23 04:10:21407 if (!writer.WriteUInt8(flags)) {
[email protected]86a318d2013-01-23 21:16:04408 return NULL;
409 }
410
[email protected]0bbeb6972013-05-23 04:10:21411 if (!writer.WriteUInt64(packet.public_header.guid)) {
[email protected]86a318d2013-01-23 21:16:04412 return NULL;
413 }
414
415 if (!writer.WriteUInt64(packet.nonce_proof)) {
416 return NULL;
417 }
418
[email protected]25c31dc2013-06-05 17:56:04419 if (!AppendPacketSequenceNumber(PACKET_6BYTE_SEQUENCE_NUMBER,
420 packet.rejected_sequence_number,
[email protected]86a318d2013-01-23 21:16:04421 &writer)) {
422 return NULL;
423 }
424
425 return new QuicEncryptedPacket(writer.take(), len, true);
426}
427
[email protected]3e60db82013-08-05 19:43:06428QuicEncryptedPacket* QuicFramer::BuildVersionNegotiationPacket(
[email protected]14e8106c2013-03-14 16:25:33429 const QuicPacketPublicHeader& header,
[email protected]48878092013-07-26 14:51:56430 const QuicVersionVector& supported_versions) {
[email protected]14e8106c2013-03-14 16:25:33431 DCHECK(header.version_flag);
432 size_t len = GetVersionNegotiationPacketSize(supported_versions.size());
433 QuicDataWriter writer(len);
434
[email protected]1354bf62013-05-23 23:17:18435 uint8 flags = static_cast<uint8>(PACKET_PUBLIC_FLAGS_VERSION |
[email protected]25c31dc2013-06-05 17:56:04436 PACKET_PUBLIC_FLAGS_8BYTE_GUID |
437 PACKET_PUBLIC_FLAGS_6BYTE_SEQUENCE);
[email protected]0bbeb6972013-05-23 04:10:21438 if (!writer.WriteUInt8(flags)) {
[email protected]14e8106c2013-03-14 16:25:33439 return NULL;
440 }
441
[email protected]0bbeb6972013-05-23 04:10:21442 if (!writer.WriteUInt64(header.guid)) {
[email protected]14e8106c2013-03-14 16:25:33443 return NULL;
444 }
445
446 for (size_t i = 0; i < supported_versions.size(); ++i) {
[email protected]48878092013-07-26 14:51:56447 if (!writer.WriteUInt32(QuicVersionToQuicTag(supported_versions[i]))) {
[email protected]14e8106c2013-03-14 16:25:33448 return NULL;
449 }
450 }
451
452 return new QuicEncryptedPacket(writer.take(), len, true);
453}
454
[email protected]fee17f72013-02-03 07:47:41455bool QuicFramer::ProcessPacket(const QuicEncryptedPacket& packet) {
[email protected]8b37a092012-10-18 21:53:49456 DCHECK(!reader_.get());
457 reader_.reset(new QuicDataReader(packet.data(), packet.length()));
[email protected]c995c572013-01-18 05:43:20458
[email protected]14e8106c2013-03-14 16:25:33459 visitor_->OnPacket();
460
[email protected]c995c572013-01-18 05:43:20461 // First parse the public header.
462 QuicPacketPublicHeader public_header;
463 if (!ProcessPublicHeader(&public_header)) {
[email protected]86a318d2013-01-23 21:16:04464 DLOG(WARNING) << "Unable to process public header.";
[email protected]691f45a982013-11-19 10:52:04465 DCHECK_NE("", detailed_error_);
[email protected]c995c572013-01-18 05:43:20466 return RaiseError(QUIC_INVALID_PACKET_HEADER);
467 }
[email protected]14e8106c2013-03-14 16:25:33468
469 if (is_server_ && public_header.version_flag &&
470 public_header.versions[0] != quic_version_) {
471 if (!visitor_->OnProtocolVersionMismatch(public_header.versions[0])) {
472 reader_.reset(NULL);
473 return true;
474 }
[email protected]5351cc4b2013-03-03 07:22:41475 }
[email protected]c995c572013-01-18 05:43:20476
[email protected]86a318d2013-01-23 21:16:04477 bool rv;
[email protected]14e8106c2013-03-14 16:25:33478 if (!is_server_ && public_header.version_flag) {
479 rv = ProcessVersionNegotiationPacket(&public_header);
480 } else if (public_header.reset_flag) {
[email protected]86a318d2013-01-23 21:16:04481 rv = ProcessPublicResetPacket(public_header);
482 } else {
[email protected]fee17f72013-02-03 07:47:41483 rv = ProcessDataPacket(public_header, packet);
[email protected]86a318d2013-01-23 21:16:04484 }
[email protected]c995c572013-01-18 05:43:20485
486 reader_.reset(NULL);
[email protected]86a318d2013-01-23 21:16:04487 return rv;
[email protected]c995c572013-01-18 05:43:20488}
489
[email protected]14e8106c2013-03-14 16:25:33490bool QuicFramer::ProcessVersionNegotiationPacket(
491 QuicPacketPublicHeader* public_header) {
492 DCHECK(!is_server_);
493 // Try reading at least once to raise error if the packet is invalid.
494 do {
[email protected]2532de12013-05-09 12:29:33495 QuicTag version;
[email protected]14e8106c2013-03-14 16:25:33496 if (!reader_->ReadBytes(&version, kQuicVersionSize)) {
497 set_detailed_error("Unable to read supported version in negotiation.");
498 return RaiseError(QUIC_INVALID_VERSION_NEGOTIATION_PACKET);
499 }
[email protected]48878092013-07-26 14:51:56500 public_header->versions.push_back(QuicTagToQuicVersion(version));
[email protected]14e8106c2013-03-14 16:25:33501 } while (!reader_->IsDoneReading());
502
503 visitor_->OnVersionNegotiationPacket(*public_header);
504 return true;
505}
506
[email protected]c995c572013-01-18 05:43:20507bool QuicFramer::ProcessDataPacket(
508 const QuicPacketPublicHeader& public_header,
[email protected]c995c572013-01-18 05:43:20509 const QuicEncryptedPacket& packet) {
[email protected]c995c572013-01-18 05:43:20510 QuicPacketHeader header(public_header);
[email protected]8b37a092012-10-18 21:53:49511 if (!ProcessPacketHeader(&header, packet)) {
[email protected]c995c572013-01-18 05:43:20512 DLOG(WARNING) << "Unable to process data packet header.";
[email protected]f00b92802013-03-06 19:42:47513 return false;
[email protected]8b37a092012-10-18 21:53:49514 }
515
516 if (!visitor_->OnPacketHeader(header)) {
[email protected]f00b92802013-03-06 19:42:47517 // The visitor suppresses further processing of the packet.
[email protected]8b37a092012-10-18 21:53:49518 return true;
519 }
520
521 if (packet.length() > kMaxPacketSize) {
522 DLOG(WARNING) << "Packet too large: " << packet.length();
523 return RaiseError(QUIC_PACKET_TOO_LARGE);
524 }
525
526 // Handle the payload.
[email protected]9db443912013-02-25 05:27:03527 if (!header.fec_flag) {
[email protected]b064310782013-05-30 21:12:17528 if (header.is_in_fec_group == IN_FEC_GROUP) {
[email protected]8b37a092012-10-18 21:53:49529 StringPiece payload = reader_->PeekRemainingPayload();
530 visitor_->OnFecProtectedPayload(payload);
531 }
[email protected]8e01c062013-10-31 07:35:31532 if (!ProcessFrameData(header)) {
[email protected]be24ab22012-10-22 03:01:52533 DCHECK_NE(QUIC_NO_ERROR, error_); // ProcessFrameData sets the error.
534 DLOG(WARNING) << "Unable to process frame data.";
[email protected]8b37a092012-10-18 21:53:49535 return false;
536 }
537 } else {
538 QuicFecData fec_data;
539 fec_data.fec_group = header.fec_group;
[email protected]8b37a092012-10-18 21:53:49540 fec_data.redundancy = reader_->ReadRemainingPayload();
541 visitor_->OnFecData(fec_data);
542 }
543
544 visitor_->OnPacketComplete();
[email protected]8b37a092012-10-18 21:53:49545 return true;
546}
547
[email protected]86a318d2013-01-23 21:16:04548bool QuicFramer::ProcessPublicResetPacket(
549 const QuicPacketPublicHeader& public_header) {
550 QuicPublicResetPacket packet(public_header);
551 if (!reader_->ReadUInt64(&packet.nonce_proof)) {
552 set_detailed_error("Unable to read nonce proof.");
[email protected]899951652013-05-16 12:52:39553 return RaiseError(QUIC_INVALID_PUBLIC_RST_PACKET);
[email protected]86a318d2013-01-23 21:16:04554 }
555 // TODO(satyamshekhar): validate nonce to protect against DoS.
556
557 if (!reader_->ReadUInt48(&packet.rejected_sequence_number)) {
558 set_detailed_error("Unable to read rejected sequence number.");
[email protected]899951652013-05-16 12:52:39559 return RaiseError(QUIC_INVALID_PUBLIC_RST_PACKET);
[email protected]86a318d2013-01-23 21:16:04560 }
[email protected]86a318d2013-01-23 21:16:04561 visitor_->OnPublicResetPacket(packet);
562 return true;
563}
564
[email protected]9db443912013-02-25 05:27:03565bool QuicFramer::ProcessRevivedPacket(QuicPacketHeader* header,
[email protected]8b37a092012-10-18 21:53:49566 StringPiece payload) {
567 DCHECK(!reader_.get());
568
[email protected]6db22a82012-10-23 17:54:17569 visitor_->OnRevivedPacket();
[email protected]8b37a092012-10-18 21:53:49570
[email protected]9db443912013-02-25 05:27:03571 header->entropy_hash = GetPacketEntropyHash(*header);
572
[email protected]899951652013-05-16 12:52:39573 if (!visitor_->OnPacketHeader(*header)) {
574 return true;
575 }
[email protected]8b37a092012-10-18 21:53:49576
577 if (payload.length() > kMaxPacketSize) {
578 set_detailed_error("Revived packet too large.");
579 return RaiseError(QUIC_PACKET_TOO_LARGE);
580 }
581
582 reader_.reset(new QuicDataReader(payload.data(), payload.length()));
[email protected]8e01c062013-10-31 07:35:31583 if (!ProcessFrameData(*header)) {
[email protected]be24ab22012-10-22 03:01:52584 DCHECK_NE(QUIC_NO_ERROR, error_); // ProcessFrameData sets the error.
585 DLOG(WARNING) << "Unable to process frame data.";
[email protected]8b37a092012-10-18 21:53:49586 return false;
587 }
588
589 visitor_->OnPacketComplete();
590 reader_.reset(NULL);
591 return true;
592}
593
[email protected]8e01c062013-10-31 07:35:31594bool QuicFramer::AppendPacketHeader(const QuicPacketHeader& header,
595 QuicDataWriter* writer) {
[email protected]b064310782013-05-30 21:12:17596 DCHECK(header.fec_group > 0 || header.is_in_fec_group == NOT_IN_FEC_GROUP);
597 uint8 public_flags = 0;
[email protected]9db443912013-02-25 05:27:03598 if (header.public_header.reset_flag) {
[email protected]b064310782013-05-30 21:12:17599 public_flags |= PACKET_PUBLIC_FLAGS_RST;
[email protected]9db443912013-02-25 05:27:03600 }
601 if (header.public_header.version_flag) {
[email protected]b064310782013-05-30 21:12:17602 public_flags |= PACKET_PUBLIC_FLAGS_VERSION;
[email protected]9db443912013-02-25 05:27:03603 }
[email protected]8e01c062013-10-31 07:35:31604
605 public_flags |=
606 GetSequenceNumberFlags(header.public_header.sequence_number_length)
607 << kPublicHeaderSequenceNumberShift;
[email protected]25c31dc2013-06-05 17:56:04608
[email protected]b064310782013-05-30 21:12:17609 switch (header.public_header.guid_length) {
610 case PACKET_0BYTE_GUID:
611 if (!writer->WriteUInt8(public_flags | PACKET_PUBLIC_FLAGS_0BYTE_GUID)) {
612 return false;
613 }
614 break;
615 case PACKET_1BYTE_GUID:
616 if (!writer->WriteUInt8(public_flags | PACKET_PUBLIC_FLAGS_1BYTE_GUID)) {
617 return false;
618 }
619 if (!writer->WriteUInt8(header.public_header.guid & k1ByteGuidMask)) {
[email protected]8e01c062013-10-31 07:35:31620 return false;
[email protected]b064310782013-05-30 21:12:17621 }
622 break;
623 case PACKET_4BYTE_GUID:
624 if (!writer->WriteUInt8(public_flags | PACKET_PUBLIC_FLAGS_4BYTE_GUID)) {
625 return false;
626 }
627 if (!writer->WriteUInt32(header.public_header.guid & k4ByteGuidMask)) {
628 return false;
629 }
630 break;
631 case PACKET_8BYTE_GUID:
632 if (!writer->WriteUInt8(public_flags | PACKET_PUBLIC_FLAGS_8BYTE_GUID)) {
633 return false;
634 }
635 if (!writer->WriteUInt64(header.public_header.guid)) {
636 return false;
637 }
638 break;
[email protected]8b37a092012-10-18 21:53:49639 }
[email protected]b064310782013-05-30 21:12:17640 last_serialized_guid_ = header.public_header.guid;
[email protected]0bbeb6972013-05-23 04:10:21641
[email protected]5351cc4b2013-03-03 07:22:41642 if (header.public_header.version_flag) {
[email protected]14e8106c2013-03-14 16:25:33643 DCHECK(!is_server_);
[email protected]48878092013-07-26 14:51:56644 writer->WriteUInt32(QuicVersionToQuicTag(quic_version_));
[email protected]5351cc4b2013-03-03 07:22:41645 }
646
[email protected]25c31dc2013-06-05 17:56:04647 if (!AppendPacketSequenceNumber(header.public_header.sequence_number_length,
648 header.packet_sequence_number, writer)) {
[email protected]c995c572013-01-18 05:43:20649 return false;
650 }
651
[email protected]b064310782013-05-30 21:12:17652 uint8 private_flags = 0;
[email protected]9db443912013-02-25 05:27:03653 if (header.entropy_flag) {
[email protected]b064310782013-05-30 21:12:17654 private_flags |= PACKET_PRIVATE_FLAGS_ENTROPY;
[email protected]9db443912013-02-25 05:27:03655 }
[email protected]b064310782013-05-30 21:12:17656 if (header.is_in_fec_group == IN_FEC_GROUP) {
657 private_flags |= PACKET_PRIVATE_FLAGS_FEC_GROUP;
[email protected]9db443912013-02-25 05:27:03658 }
[email protected]b064310782013-05-30 21:12:17659 if (header.fec_flag) {
660 private_flags |= PACKET_PRIVATE_FLAGS_FEC;
661 }
662 if (!writer->WriteUInt8(private_flags)) {
[email protected]86a318d2013-01-23 21:16:04663 return false;
[email protected]8b37a092012-10-18 21:53:49664 }
665
[email protected]c995c572013-01-18 05:43:20666 // The FEC group number is the sequence number of the first fec
667 // protected packet, or 0 if this packet is not protected.
[email protected]b064310782013-05-30 21:12:17668 if (header.is_in_fec_group == IN_FEC_GROUP) {
[email protected]c995c572013-01-18 05:43:20669 DCHECK_GE(header.packet_sequence_number, header.fec_group);
670 DCHECK_GT(255u, header.packet_sequence_number - header.fec_group);
[email protected]b064310782013-05-30 21:12:17671 // Offset from the current packet sequence number to the first fec
672 // protected packet.
673 uint8 first_fec_protected_packet_offset =
[email protected]c995c572013-01-18 05:43:20674 header.packet_sequence_number - header.fec_group;
[email protected]b064310782013-05-30 21:12:17675 if (!writer->WriteBytes(&first_fec_protected_packet_offset, 1)) {
676 return false;
677 }
[email protected]8b37a092012-10-18 21:53:49678 }
679
680 return true;
681}
682
[email protected]c995c572013-01-18 05:43:20683QuicPacketSequenceNumber QuicFramer::CalculatePacketSequenceNumberFromWire(
[email protected]25c31dc2013-06-05 17:56:04684 QuicSequenceNumberLength sequence_number_length,
[email protected]c995c572013-01-18 05:43:20685 QuicPacketSequenceNumber packet_sequence_number) const {
[email protected]9db443912013-02-25 05:27:03686 // The new sequence number might have wrapped to the next epoch, or
[email protected]c995c572013-01-18 05:43:20687 // it might have reverse wrapped to the previous epoch, or it might
688 // remain in the same epoch. Select the sequence number closest to the
[email protected]25c31dc2013-06-05 17:56:04689 // next expected sequence number, the previous sequence number plus 1.
[email protected]c995c572013-01-18 05:43:20690
[email protected]25c31dc2013-06-05 17:56:04691 // epoch_delta is the delta between epochs the sequence number was serialized
692 // with, so the correct value is likely the same epoch as the last sequence
693 // number or an adjacent epoch.
694 const QuicPacketSequenceNumber epoch_delta =
695 GG_UINT64_C(1) << (8 * sequence_number_length);
696 QuicPacketSequenceNumber next_sequence_number = last_sequence_number_ + 1;
697 QuicPacketSequenceNumber epoch = last_sequence_number_ & ~(epoch_delta - 1);
698 QuicPacketSequenceNumber prev_epoch = epoch - epoch_delta;
699 QuicPacketSequenceNumber next_epoch = epoch + epoch_delta;
700
701 return ClosestTo(next_sequence_number,
[email protected]c995c572013-01-18 05:43:20702 epoch + packet_sequence_number,
[email protected]25c31dc2013-06-05 17:56:04703 ClosestTo(next_sequence_number,
[email protected]c995c572013-01-18 05:43:20704 prev_epoch + packet_sequence_number,
705 next_epoch + packet_sequence_number));
706}
707
[email protected]25c31dc2013-06-05 17:56:04708bool QuicFramer::ProcessPublicHeader(
709 QuicPacketPublicHeader* public_header) {
[email protected]c995c572013-01-18 05:43:20710 uint8 public_flags;
711 if (!reader_->ReadBytes(&public_flags, 1)) {
712 set_detailed_error("Unable to read public flags.");
[email protected]e537f742012-12-07 15:33:53713 return false;
714 }
[email protected]8b37a092012-10-18 21:53:49715
[email protected]69dfd1b2013-06-04 22:20:12716 public_header->reset_flag = (public_flags & PACKET_PUBLIC_FLAGS_RST) != 0;
717 public_header->version_flag =
718 (public_flags & PACKET_PUBLIC_FLAGS_VERSION) != 0;
719
[email protected]25c31dc2013-06-05 17:56:04720 if (!public_header->version_flag && public_flags > PACKET_PUBLIC_FLAGS_MAX) {
721 set_detailed_error("Illegal public flags value.");
722 return false;
723 }
724
[email protected]14e8106c2013-03-14 16:25:33725 if (public_header->reset_flag && public_header->version_flag) {
726 set_detailed_error("Got version flag in reset packet");
[email protected]5351cc4b2013-03-03 07:22:41727 return false;
728 }
729
[email protected]b064310782013-05-30 21:12:17730 switch (public_flags & PACKET_PUBLIC_FLAGS_8BYTE_GUID) {
731 case PACKET_PUBLIC_FLAGS_8BYTE_GUID:
732 if (!reader_->ReadUInt64(&public_header->guid)) {
733 set_detailed_error("Unable to read GUID.");
734 return false;
735 }
736 public_header->guid_length = PACKET_8BYTE_GUID;
737 break;
738 case PACKET_PUBLIC_FLAGS_4BYTE_GUID:
739 // If the guid is truncated, expect to read the last serialized guid.
740 if (!reader_->ReadBytes(&public_header->guid, PACKET_4BYTE_GUID)) {
741 set_detailed_error("Unable to read GUID.");
742 return false;
743 }
744 if ((public_header->guid & k4ByteGuidMask) !=
745 (last_serialized_guid_ & k4ByteGuidMask)) {
746 set_detailed_error(
747 "Truncated 4 byte GUID does not match previous guid.");
748 return false;
749 }
750 public_header->guid_length = PACKET_4BYTE_GUID;
751 public_header->guid = last_serialized_guid_;
752 break;
753 case PACKET_PUBLIC_FLAGS_1BYTE_GUID:
754 if (!reader_->ReadBytes(&public_header->guid, PACKET_1BYTE_GUID)) {
755 set_detailed_error("Unable to read GUID.");
756 return false;
757 }
758 if ((public_header->guid & k1ByteGuidMask) !=
759 (last_serialized_guid_ & k1ByteGuidMask)) {
760 set_detailed_error(
761 "Truncated 1 byte GUID does not match previous guid.");
762 return false;
763 }
764 public_header->guid_length = PACKET_1BYTE_GUID;
765 public_header->guid = last_serialized_guid_;
766 break;
767 case PACKET_PUBLIC_FLAGS_0BYTE_GUID:
768 public_header->guid_length = PACKET_0BYTE_GUID;
769 public_header->guid = last_serialized_guid_;
770 break;
[email protected]0bbeb6972013-05-23 04:10:21771 }
772
[email protected]8e01c062013-10-31 07:35:31773 public_header->sequence_number_length =
774 ReadSequenceNumberLength(
775 public_flags >> kPublicHeaderSequenceNumberShift);
[email protected]25c31dc2013-06-05 17:56:04776
[email protected]48878092013-07-26 14:51:56777 // Read the version only if the packet is from the client.
778 // version flag from the server means version negotiation packet.
[email protected]14e8106c2013-03-14 16:25:33779 if (public_header->version_flag && is_server_) {
[email protected]48878092013-07-26 14:51:56780 QuicTag version_tag;
781 if (!reader_->ReadUInt32(&version_tag)) {
[email protected]14e8106c2013-03-14 16:25:33782 set_detailed_error("Unable to read protocol version.");
783 return false;
784 }
[email protected]48878092013-07-26 14:51:56785
786 // If the version from the new packet is the same as the version of this
787 // framer, then the public flags should be set to something we understand.
788 // If not, this raises an error.
789 QuicVersion version = QuicTagToQuicVersion(version_tag);
[email protected]25c31dc2013-06-05 17:56:04790 if (version == quic_version_ && public_flags > PACKET_PUBLIC_FLAGS_MAX) {
791 set_detailed_error("Illegal public flags value.");
792 return false;
793 }
[email protected]14e8106c2013-03-14 16:25:33794 public_header->versions.push_back(version);
795 }
[email protected]c995c572013-01-18 05:43:20796 return true;
797}
798
[email protected]fee17f72013-02-03 07:47:41799// static
800bool QuicFramer::ReadGuidFromPacket(const QuicEncryptedPacket& packet,
801 QuicGuid* guid) {
802 QuicDataReader reader(packet.data(), packet.length());
[email protected]0bbeb6972013-05-23 04:10:21803 uint8 public_flags;
804 if (!reader.ReadBytes(&public_flags, 1)) {
805 return false;
806 }
[email protected]1354bf62013-05-23 23:17:18807 // Ensure it's an 8 byte guid.
808 if ((public_flags & PACKET_PUBLIC_FLAGS_8BYTE_GUID) !=
809 PACKET_PUBLIC_FLAGS_8BYTE_GUID) {
810 return false;
811 }
[email protected]0bbeb6972013-05-23 04:10:21812
[email protected]fee17f72013-02-03 07:47:41813 return reader.ReadUInt64(guid);
814}
815
[email protected]8e01c062013-10-31 07:35:31816// static
817QuicSequenceNumberLength QuicFramer::ReadSequenceNumberLength(uint8 flags) {
818 switch (flags & PACKET_FLAGS_6BYTE_SEQUENCE) {
819 case PACKET_FLAGS_6BYTE_SEQUENCE:
820 return PACKET_6BYTE_SEQUENCE_NUMBER;
821 case PACKET_FLAGS_4BYTE_SEQUENCE:
822 return PACKET_4BYTE_SEQUENCE_NUMBER;
823 case PACKET_FLAGS_2BYTE_SEQUENCE:
824 return PACKET_2BYTE_SEQUENCE_NUMBER;
825 case PACKET_FLAGS_1BYTE_SEQUENCE:
826 return PACKET_1BYTE_SEQUENCE_NUMBER;
827 default:
828 LOG(DFATAL) << "Unreachable case statement.";
829 return PACKET_6BYTE_SEQUENCE_NUMBER;
830 }
831}
832
833// static
834QuicSequenceNumberLength QuicFramer::GetMinSequenceNumberLength(
835 QuicPacketSequenceNumber sequence_number) {
836 if (sequence_number < 1 << (PACKET_1BYTE_SEQUENCE_NUMBER * 8)) {
837 return PACKET_1BYTE_SEQUENCE_NUMBER;
838 } else if (sequence_number < 1 << (PACKET_2BYTE_SEQUENCE_NUMBER * 8)) {
839 return PACKET_2BYTE_SEQUENCE_NUMBER;
840 } else if (sequence_number <
841 GG_UINT64_C(1) << (PACKET_4BYTE_SEQUENCE_NUMBER * 8)) {
842 return PACKET_4BYTE_SEQUENCE_NUMBER;
843 } else {
844 return PACKET_6BYTE_SEQUENCE_NUMBER;
845 }
846}
847
848// static
849uint8 QuicFramer::GetSequenceNumberFlags(
850 QuicSequenceNumberLength sequence_number_length) {
851 switch (sequence_number_length) {
852 case PACKET_1BYTE_SEQUENCE_NUMBER:
853 return PACKET_FLAGS_1BYTE_SEQUENCE;
854 case PACKET_2BYTE_SEQUENCE_NUMBER:
855 return PACKET_FLAGS_2BYTE_SEQUENCE;
856 case PACKET_4BYTE_SEQUENCE_NUMBER:
857 return PACKET_FLAGS_4BYTE_SEQUENCE;
858 case PACKET_6BYTE_SEQUENCE_NUMBER:
859 return PACKET_FLAGS_6BYTE_SEQUENCE;
860 default:
861 LOG(DFATAL) << "Unreachable case statement.";
862 return PACKET_FLAGS_6BYTE_SEQUENCE;
863 }
864}
865
866// static
867QuicFramer::AckFrameInfo QuicFramer::GetAckFrameInfo(
868 const QuicAckFrame& frame) {
869 const ReceivedPacketInfo& received_info = frame.received_info;
870
871 AckFrameInfo ack_info;
872 if (!received_info.missing_packets.empty()) {
[email protected]933da772013-11-13 20:45:46873 DCHECK_GE(received_info.largest_observed,
874 *received_info.missing_packets.rbegin());
[email protected]8e01c062013-10-31 07:35:31875 size_t cur_range_length = 0;
876 SequenceNumberSet::const_iterator iter =
877 received_info.missing_packets.begin();
878 QuicPacketSequenceNumber last_missing = *iter;
879 ++iter;
880 for (; iter != received_info.missing_packets.end(); ++iter) {
881 if (cur_range_length != numeric_limits<uint8>::max() &&
882 *iter == (last_missing + 1)) {
883 ++cur_range_length;
884 } else {
885 ack_info.nack_ranges[last_missing - cur_range_length]
886 = cur_range_length;
887 cur_range_length = 0;
888 }
889 ack_info.max_delta = max(ack_info.max_delta, *iter - last_missing);
890 last_missing = *iter;
891 }
892 // Include the last nack range.
893 ack_info.nack_ranges[last_missing - cur_range_length] = cur_range_length;
894 // Include the range to the largest observed.
895 ack_info.max_delta = max(ack_info.max_delta,
896 received_info.largest_observed - last_missing);
897 }
898 return ack_info;
899}
900
[email protected]c995c572013-01-18 05:43:20901bool QuicFramer::ProcessPacketHeader(
902 QuicPacketHeader* header,
903 const QuicEncryptedPacket& packet) {
[email protected]25c31dc2013-06-05 17:56:04904 if (!ProcessPacketSequenceNumber(header->public_header.sequence_number_length,
905 &header->packet_sequence_number)) {
[email protected]c995c572013-01-18 05:43:20906 set_detailed_error("Unable to read sequence number.");
[email protected]f00b92802013-03-06 19:42:47907 return RaiseError(QUIC_INVALID_PACKET_HEADER);
[email protected]c995c572013-01-18 05:43:20908 }
909
910 if (header->packet_sequence_number == 0u) {
911 set_detailed_error("Packet sequence numbers cannot be 0.");
[email protected]f00b92802013-03-06 19:42:47912 return RaiseError(QUIC_INVALID_PACKET_HEADER);
[email protected]c995c572013-01-18 05:43:20913 }
[email protected]8b37a092012-10-18 21:53:49914
[email protected]ec86d5462013-11-17 16:04:49915 if (!visitor_->OnUnauthenticatedHeader(*header)) {
916 return false;
917 }
918
[email protected]25c31dc2013-06-05 17:56:04919 if (!DecryptPayload(*header, packet)) {
[email protected]f00b92802013-03-06 19:42:47920 set_detailed_error("Unable to decrypt payload.");
[email protected]8b37a092012-10-18 21:53:49921 return RaiseError(QUIC_DECRYPTION_FAILURE);
922 }
923
[email protected]c995c572013-01-18 05:43:20924 uint8 private_flags;
925 if (!reader_->ReadBytes(&private_flags, 1)) {
926 set_detailed_error("Unable to read private flags.");
[email protected]f00b92802013-03-06 19:42:47927 return RaiseError(QUIC_INVALID_PACKET_HEADER);
[email protected]8b37a092012-10-18 21:53:49928 }
929
[email protected]c995c572013-01-18 05:43:20930 if (private_flags > PACKET_PRIVATE_FLAGS_MAX) {
931 set_detailed_error("Illegal private flags value.");
[email protected]f00b92802013-03-06 19:42:47932 return RaiseError(QUIC_INVALID_PACKET_HEADER);
[email protected]c995c572013-01-18 05:43:20933 }
934
[email protected]9db443912013-02-25 05:27:03935 header->entropy_flag = (private_flags & PACKET_PRIVATE_FLAGS_ENTROPY) != 0;
[email protected]b064310782013-05-30 21:12:17936 header->fec_flag = (private_flags & PACKET_PRIVATE_FLAGS_FEC) != 0;
[email protected]c995c572013-01-18 05:43:20937
[email protected]b064310782013-05-30 21:12:17938 if ((private_flags & PACKET_PRIVATE_FLAGS_FEC_GROUP) != 0) {
939 header->is_in_fec_group = IN_FEC_GROUP;
940 uint8 first_fec_protected_packet_offset;
941 if (!reader_->ReadBytes(&first_fec_protected_packet_offset, 1)) {
942 set_detailed_error("Unable to read first fec protected packet offset.");
943 return RaiseError(QUIC_INVALID_PACKET_HEADER);
944 }
[email protected]3e60db82013-08-05 19:43:06945 if (first_fec_protected_packet_offset >= header->packet_sequence_number) {
946 set_detailed_error("First fec protected packet offset must be less "
947 "than the sequence number.");
948 return RaiseError(QUIC_INVALID_PACKET_HEADER);
949 }
[email protected]b064310782013-05-30 21:12:17950 header->fec_group =
951 header->packet_sequence_number - first_fec_protected_packet_offset;
[email protected]c995c572013-01-18 05:43:20952 }
[email protected]c995c572013-01-18 05:43:20953
[email protected]9db443912013-02-25 05:27:03954 header->entropy_hash = GetPacketEntropyHash(*header);
[email protected]c995c572013-01-18 05:43:20955 // Set the last sequence number after we have decrypted the packet
956 // so we are confident is not attacker controlled.
957 last_sequence_number_ = header->packet_sequence_number;
958 return true;
959}
960
961bool QuicFramer::ProcessPacketSequenceNumber(
[email protected]25c31dc2013-06-05 17:56:04962 QuicSequenceNumberLength sequence_number_length,
[email protected]c995c572013-01-18 05:43:20963 QuicPacketSequenceNumber* sequence_number) {
[email protected]25c31dc2013-06-05 17:56:04964 QuicPacketSequenceNumber wire_sequence_number = 0u;
965 if (!reader_->ReadBytes(&wire_sequence_number, sequence_number_length)) {
[email protected]c995c572013-01-18 05:43:20966 return false;
967 }
968
[email protected]25c31dc2013-06-05 17:56:04969 // TODO(ianswett): Explore the usefulness of trying multiple sequence numbers
970 // in case the first guess is incorrect.
[email protected]c995c572013-01-18 05:43:20971 *sequence_number =
[email protected]25c31dc2013-06-05 17:56:04972 CalculatePacketSequenceNumberFromWire(sequence_number_length,
973 wire_sequence_number);
[email protected]8b37a092012-10-18 21:53:49974 return true;
975}
976
[email protected]8e01c062013-10-31 07:35:31977bool QuicFramer::ProcessFrameData(const QuicPacketHeader& header) {
[email protected]86a318d2013-01-23 21:16:04978 if (reader_->IsDoneReading()) {
[email protected]89264042013-08-21 07:35:24979 set_detailed_error("Packet has no frames.");
980 return RaiseError(QUIC_MISSING_PAYLOAD);
[email protected]8b37a092012-10-18 21:53:49981 }
[email protected]86a318d2013-01-23 21:16:04982 while (!reader_->IsDoneReading()) {
[email protected]be24ab22012-10-22 03:01:52983 uint8 frame_type;
984 if (!reader_->ReadBytes(&frame_type, 1)) {
985 set_detailed_error("Unable to read frame type.");
986 return RaiseError(QUIC_INVALID_FRAME_DATA);
[email protected]8b37a092012-10-18 21:53:49987 }
[email protected]3e60db82013-08-05 19:43:06988
[email protected]8f547ea2013-10-24 05:55:04989 if (frame_type & kQuicFrameTypeSpecialMask) {
990 // Stream Frame
991 if (frame_type & kQuicFrameTypeStreamMask) {
[email protected]97cf3022013-09-05 14:30:16992 QuicStreamFrame frame;
993 if (!ProcessStreamFrame(frame_type, &frame)) {
994 return RaiseError(QUIC_INVALID_STREAM_DATA);
[email protected]8b37a092012-10-18 21:53:49995 }
[email protected]97cf3022013-09-05 14:30:16996 if (!visitor_->OnStreamFrame(frame)) {
[email protected]3e5fed12013-11-22 22:21:41997 DVLOG(1) << "Visitor asked to stop further processing.";
[email protected]a57e0272013-04-26 07:31:47998 // Returning true since there was no parsing error.
999 return true;
1000 }
[email protected]3e60db82013-08-05 19:43:061001 continue;
[email protected]a57e0272013-04-26 07:31:471002 }
[email protected]3e60db82013-08-05 19:43:061003
[email protected]8f547ea2013-10-24 05:55:041004 // Ack Frame
1005 if (frame_type & kQuicFrameTypeAckMask) {
[email protected]97cf3022013-09-05 14:30:161006 QuicAckFrame frame;
[email protected]8e01c062013-10-31 07:35:311007 if (!ProcessAckFrame(header, frame_type, &frame)) {
[email protected]97cf3022013-09-05 14:30:161008 return RaiseError(QUIC_INVALID_ACK_DATA);
[email protected]8b37a092012-10-18 21:53:491009 }
[email protected]97cf3022013-09-05 14:30:161010 if (!visitor_->OnAckFrame(frame)) {
[email protected]3e5fed12013-11-22 22:21:411011 DVLOG(1) << "Visitor asked to stop further processing.";
[email protected]a57e0272013-04-26 07:31:471012 // Returning true since there was no parsing error.
1013 return true;
[email protected]9db443912013-02-25 05:27:031014 }
[email protected]3e60db82013-08-05 19:43:061015 continue;
[email protected]a57e0272013-04-26 07:31:471016 }
[email protected]3e60db82013-08-05 19:43:061017
[email protected]8f547ea2013-10-24 05:55:041018 // Congestion Feedback Frame
1019 if (frame_type & kQuicFrameTypeCongestionFeedbackMask) {
[email protected]97cf3022013-09-05 14:30:161020 QuicCongestionFeedbackFrame frame;
1021 if (!ProcessQuicCongestionFeedbackFrame(&frame)) {
1022 return RaiseError(QUIC_INVALID_CONGESTION_FEEDBACK_DATA);
[email protected]a57e0272013-04-26 07:31:471023 }
[email protected]97cf3022013-09-05 14:30:161024 if (!visitor_->OnCongestionFeedbackFrame(frame)) {
[email protected]3e5fed12013-11-22 22:21:411025 DVLOG(1) << "Visitor asked to stop further processing.";
[email protected]a57e0272013-04-26 07:31:471026 // Returning true since there was no parsing error.
1027 return true;
1028 }
[email protected]3e60db82013-08-05 19:43:061029 continue;
[email protected]a57e0272013-04-26 07:31:471030 }
[email protected]3e60db82013-08-05 19:43:061031
[email protected]8f547ea2013-10-24 05:55:041032 // This was a special frame type that did not match any
1033 // of the known ones. Error.
1034 set_detailed_error("Illegal frame type.");
1035 DLOG(WARNING) << "Illegal frame type: "
1036 << static_cast<int>(frame_type);
1037 return RaiseError(QUIC_INVALID_FRAME_DATA);
1038 }
1039
1040 switch (frame_type) {
1041 case PADDING_FRAME:
1042 // We're done with the packet.
1043 return true;
1044
1045 case RST_STREAM_FRAME: {
1046 QuicRstStreamFrame frame;
1047 if (!ProcessRstStreamFrame(&frame)) {
1048 return RaiseError(QUIC_INVALID_RST_STREAM_DATA);
1049 }
1050 if (!visitor_->OnRstStreamFrame(frame)) {
[email protected]3e5fed12013-11-22 22:21:411051 DVLOG(1) << "Visitor asked to stop further processing.";
[email protected]8f547ea2013-10-24 05:55:041052 // Returning true since there was no parsing error.
[email protected]97cf3022013-09-05 14:30:161053 return true;
[email protected]97cf3022013-09-05 14:30:161054 }
[email protected]8f547ea2013-10-24 05:55:041055 continue;
[email protected]97cf3022013-09-05 14:30:161056 }
[email protected]97cf3022013-09-05 14:30:161057
[email protected]8f547ea2013-10-24 05:55:041058 case CONNECTION_CLOSE_FRAME: {
1059 QuicConnectionCloseFrame frame;
1060 if (!ProcessConnectionCloseFrame(&frame)) {
1061 return RaiseError(QUIC_INVALID_CONNECTION_CLOSE_DATA);
[email protected]97cf3022013-09-05 14:30:161062 }
1063
[email protected]8f547ea2013-10-24 05:55:041064 if (!visitor_->OnConnectionCloseFrame(frame)) {
[email protected]3e5fed12013-11-22 22:21:411065 DVLOG(1) << "Visitor asked to stop further processing.";
[email protected]8f547ea2013-10-24 05:55:041066 // Returning true since there was no parsing error.
1067 return true;
[email protected]97cf3022013-09-05 14:30:161068 }
[email protected]8f547ea2013-10-24 05:55:041069 continue;
1070 }
[email protected]97cf3022013-09-05 14:30:161071
[email protected]8f547ea2013-10-24 05:55:041072 case GOAWAY_FRAME: {
1073 QuicGoAwayFrame goaway_frame;
1074 if (!ProcessGoAwayFrame(&goaway_frame)) {
1075 return RaiseError(QUIC_INVALID_GOAWAY_DATA);
1076 }
1077 if (!visitor_->OnGoAwayFrame(goaway_frame)) {
[email protected]3e5fed12013-11-22 22:21:411078 DVLOG(1) << "Visitor asked to stop further processing.";
[email protected]8f547ea2013-10-24 05:55:041079 // Returning true since there was no parsing error.
1080 return true;
1081 }
1082 continue;
1083 }
1084
1085 default:
[email protected]97cf3022013-09-05 14:30:161086 set_detailed_error("Illegal frame type.");
1087 DLOG(WARNING) << "Illegal frame type: "
1088 << static_cast<int>(frame_type);
1089 return RaiseError(QUIC_INVALID_FRAME_DATA);
[email protected]8b37a092012-10-18 21:53:491090 }
1091 }
1092
1093 return true;
1094}
1095
[email protected]3e60db82013-08-05 19:43:061096bool QuicFramer::ProcessStreamFrame(uint8 frame_type,
1097 QuicStreamFrame* frame) {
[email protected]97cf3022013-09-05 14:30:161098 uint8 stream_flags = frame_type;
1099
[email protected]8f547ea2013-10-24 05:55:041100 stream_flags &= ~kQuicFrameTypeStreamMask;
[email protected]97cf3022013-09-05 14:30:161101
[email protected]3e60db82013-08-05 19:43:061102 // Read from right to left: StreamID, Offset, Data Length, Fin.
1103 const uint8 stream_id_length = (stream_flags & kQuicStreamIDLengthMask) + 1;
1104 stream_flags >>= kQuicStreamIdShift;
1105
1106 uint8 offset_length = (stream_flags & kQuicStreamOffsetMask);
1107 // There is no encoding for 1 byte, only 0 and 2 through 8.
1108 if (offset_length > 0) {
1109 offset_length += 1;
1110 }
1111 stream_flags >>= kQuicStreamOffsetShift;
1112
1113 bool has_data_length =
1114 (stream_flags & kQuicStreamDataLengthMask) == kQuicStreamDataLengthMask;
1115 stream_flags >>= kQuicStreamDataLengthShift;
1116
1117 frame->fin = (stream_flags & kQuicStreamFinMask) == kQuicStreamFinShift;
1118
1119 frame->stream_id = 0;
1120 if (!reader_->ReadBytes(&frame->stream_id, stream_id_length)) {
1121 set_detailed_error("Unable to read stream_id.");
1122 return false;
1123 }
1124
1125 frame->offset = 0;
1126 if (!reader_->ReadBytes(&frame->offset, offset_length)) {
1127 set_detailed_error("Unable to read offset.");
1128 return false;
1129 }
1130
[email protected]5dafdb62013-11-14 01:24:261131 StringPiece frame_data;
[email protected]3e60db82013-08-05 19:43:061132 if (has_data_length) {
[email protected]5dafdb62013-11-14 01:24:261133 if (!reader_->ReadStringPiece16(&frame_data)) {
[email protected]3e60db82013-08-05 19:43:061134 set_detailed_error("Unable to read frame data.");
1135 return false;
1136 }
1137 } else {
[email protected]5dafdb62013-11-14 01:24:261138 if (!reader_->ReadStringPiece(&frame_data, reader_->BytesRemaining())) {
[email protected]3e60db82013-08-05 19:43:061139 set_detailed_error("Unable to read frame data.");
1140 return false;
1141 }
1142 }
[email protected]5dafdb62013-11-14 01:24:261143 // Point frame to the right data.
1144 frame->data.Clear();
1145 if (!frame_data.empty()) {
1146 frame->data.Append(const_cast<char*>(frame_data.data()), frame_data.size());
1147 }
[email protected]3e60db82013-08-05 19:43:061148
1149 return true;
1150}
1151
[email protected]8e01c062013-10-31 07:35:311152bool QuicFramer::ProcessAckFrame(const QuicPacketHeader& header,
1153 uint8 frame_type,
1154 QuicAckFrame* frame) {
1155 if (!ProcessSentInfo(header, &frame->sent_info)) {
[email protected]e537f742012-12-07 15:33:531156 return false;
1157 }
[email protected]31ae854842013-11-27 00:05:461158 if (!ProcessReceivedInfo(frame_type, &frame->received_info)) {
[email protected]9db443912013-02-25 05:27:031159 return false;
1160 }
[email protected]e537f742012-12-07 15:33:531161 return true;
1162}
[email protected]8b37a092012-10-18 21:53:491163
[email protected]8e01c062013-10-31 07:35:311164bool QuicFramer::ProcessReceivedInfo(uint8 frame_type,
1165 ReceivedPacketInfo* received_info) {
1166 // Determine the three lengths from the frame type: largest observed length,
1167 // missing sequence number length, and missing range length.
1168 const QuicSequenceNumberLength missing_sequence_number_length =
1169 ReadSequenceNumberLength(frame_type);
1170 frame_type >>= kQuicSequenceNumberLengthShift;
1171 const QuicSequenceNumberLength largest_observed_sequence_number_length =
1172 ReadSequenceNumberLength(frame_type);
1173 frame_type >>= kQuicSequenceNumberLengthShift;
1174 received_info->is_truncated = frame_type & kQuicAckTruncatedMask;
1175 frame_type >>= kQuicAckTruncatedShift;
1176 bool has_nacks = frame_type & kQuicHasNacksMask;
1177
1178 if (!reader_->ReadBytes(&received_info->entropy_hash, 1)) {
1179 set_detailed_error("Unable to read entropy hash for received packets.");
1180 return false;
1181 }
1182
1183 if (!reader_->ReadBytes(&received_info->largest_observed,
1184 largest_observed_sequence_number_length)) {
1185 set_detailed_error("Unable to read largest observed.");
1186 return false;
1187 }
1188
1189 uint64 delta_time_largest_observed_us;
1190 if (!reader_->ReadUFloat16(&delta_time_largest_observed_us)) {
1191 set_detailed_error("Unable to read delta time largest observed.");
1192 return false;
1193 }
1194
1195 if (delta_time_largest_observed_us == kUFloat16MaxValue) {
1196 received_info->delta_time_largest_observed = QuicTime::Delta::Infinite();
1197 } else {
1198 received_info->delta_time_largest_observed =
1199 QuicTime::Delta::FromMicroseconds(delta_time_largest_observed_us);
1200 }
1201
1202 if (!has_nacks) {
1203 return true;
1204 }
1205
1206 uint8 num_missing_ranges;
1207 if (!reader_->ReadBytes(&num_missing_ranges, 1)) {
1208 set_detailed_error("Unable to read num missing packet ranges.");
1209 return false;
1210 }
1211
1212 QuicPacketSequenceNumber last_sequence_number =
1213 received_info->largest_observed;
1214 for (size_t i = 0; i < num_missing_ranges; ++i) {
1215 QuicPacketSequenceNumber missing_delta = 0;
1216 if (!reader_->ReadBytes(&missing_delta, missing_sequence_number_length)) {
1217 set_detailed_error("Unable to read missing sequence number delta.");
1218 return false;
1219 }
1220 last_sequence_number -= missing_delta;
1221 QuicPacketSequenceNumber range_length = 0;
1222 if (!reader_->ReadBytes(&range_length, PACKET_1BYTE_SEQUENCE_NUMBER)) {
1223 set_detailed_error("Unable to read missing sequence number range.");
1224 return false;
1225 }
1226 for (size_t i = 0; i <= range_length; ++i) {
1227 received_info->missing_packets.insert(last_sequence_number - i);
1228 }
1229 // Subtract an extra 1 to ensure ranges are represented efficiently and
1230 // can't overlap by 1 sequence number. This allows a missing_delta of 0
1231 // to represent an adjacent nack range.
1232 last_sequence_number -= (range_length + 1);
1233 }
1234
1235 return true;
1236}
1237
1238bool QuicFramer::ProcessSentInfo(const QuicPacketHeader& header,
1239 SentPacketInfo* sent_info) {
[email protected]9db443912013-02-25 05:27:031240 if (!reader_->ReadBytes(&sent_info->entropy_hash, 1)) {
1241 set_detailed_error("Unable to read entropy hash for sent packets.");
1242 return false;
1243 }
1244
[email protected]31ae854842013-11-27 00:05:461245 QuicPacketSequenceNumber least_unacked_delta = 0;
1246 if (!reader_->ReadBytes(&least_unacked_delta,
1247 header.public_header.sequence_number_length)) {
1248 set_detailed_error("Unable to read least unacked delta.");
1249 return false;
[email protected]8b37a092012-10-18 21:53:491250 }
[email protected]31ae854842013-11-27 00:05:461251 DCHECK_GE(header.packet_sequence_number, least_unacked_delta);
1252 sent_info->least_unacked =
1253 header.packet_sequence_number - least_unacked_delta;
[email protected]8b37a092012-10-18 21:53:491254
[email protected]e537f742012-12-07 15:33:531255 return true;
1256}
1257
[email protected]26f3f8e2012-12-13 21:07:191258bool QuicFramer::ProcessQuicCongestionFeedbackFrame(
1259 QuicCongestionFeedbackFrame* frame) {
1260 uint8 feedback_type;
1261 if (!reader_->ReadBytes(&feedback_type, 1)) {
1262 set_detailed_error("Unable to read congestion feedback type.");
[email protected]8b37a092012-10-18 21:53:491263 return false;
1264 }
[email protected]26f3f8e2012-12-13 21:07:191265 frame->type =
1266 static_cast<CongestionFeedbackType>(feedback_type);
[email protected]8b37a092012-10-18 21:53:491267
[email protected]26f3f8e2012-12-13 21:07:191268 switch (frame->type) {
[email protected]8b37a092012-10-18 21:53:491269 case kInterArrival: {
1270 CongestionFeedbackMessageInterArrival* inter_arrival =
[email protected]26f3f8e2012-12-13 21:07:191271 &frame->inter_arrival;
[email protected]8b37a092012-10-18 21:53:491272 if (!reader_->ReadUInt16(
1273 &inter_arrival->accumulated_number_of_lost_packets)) {
1274 set_detailed_error(
1275 "Unable to read accumulated number of lost packets.");
1276 return false;
1277 }
[email protected]7884ecad2012-12-14 22:55:151278 uint8 num_received_packets;
1279 if (!reader_->ReadBytes(&num_received_packets, 1)) {
1280 set_detailed_error("Unable to read num received packets.");
1281 return false;
1282 }
1283
1284 if (num_received_packets > 0u) {
1285 uint64 smallest_received;
[email protected]25c31dc2013-06-05 17:56:041286 if (!ProcessPacketSequenceNumber(PACKET_6BYTE_SEQUENCE_NUMBER,
1287 &smallest_received)) {
[email protected]7884ecad2012-12-14 22:55:151288 set_detailed_error("Unable to read smallest received.");
1289 return false;
1290 }
1291
1292 uint64 time_received_us;
1293 if (!reader_->ReadUInt64(&time_received_us)) {
1294 set_detailed_error("Unable to read time received.");
1295 return false;
1296 }
[email protected]74bda142013-03-31 02:49:111297 QuicTime time_received = creation_time_.Add(
1298 QuicTime::Delta::FromMicroseconds(time_received_us));
[email protected]7884ecad2012-12-14 22:55:151299
[email protected]c995c572013-01-18 05:43:201300 inter_arrival->received_packet_times.insert(
[email protected]74bda142013-03-31 02:49:111301 make_pair(smallest_received, time_received));
[email protected]7884ecad2012-12-14 22:55:151302
[email protected]8e01c062013-10-31 07:35:311303 for (uint8 i = 0; i < num_received_packets - 1; ++i) {
[email protected]7884ecad2012-12-14 22:55:151304 uint16 sequence_delta;
1305 if (!reader_->ReadUInt16(&sequence_delta)) {
1306 set_detailed_error(
1307 "Unable to read sequence delta in received packets.");
1308 return false;
1309 }
1310
1311 int32 time_delta_us;
1312 if (!reader_->ReadBytes(&time_delta_us, sizeof(time_delta_us))) {
1313 set_detailed_error(
1314 "Unable to read time delta in received packets.");
1315 return false;
1316 }
1317 QuicPacketSequenceNumber packet = smallest_received + sequence_delta;
[email protected]c995c572013-01-18 05:43:201318 inter_arrival->received_packet_times.insert(
[email protected]74bda142013-03-31 02:49:111319 make_pair(packet, time_received.Add(
1320 QuicTime::Delta::FromMicroseconds(time_delta_us))));
[email protected]7884ecad2012-12-14 22:55:151321 }
1322 }
[email protected]8b37a092012-10-18 21:53:491323 break;
1324 }
1325 case kFixRate: {
[email protected]fee17f72013-02-03 07:47:411326 uint32 bitrate = 0;
1327 if (!reader_->ReadUInt32(&bitrate)) {
[email protected]8b37a092012-10-18 21:53:491328 set_detailed_error("Unable to read bitrate.");
1329 return false;
1330 }
[email protected]fee17f72013-02-03 07:47:411331 frame->fix_rate.bitrate = QuicBandwidth::FromBytesPerSecond(bitrate);
[email protected]8b37a092012-10-18 21:53:491332 break;
1333 }
1334 case kTCP: {
[email protected]26f3f8e2012-12-13 21:07:191335 CongestionFeedbackMessageTCP* tcp = &frame->tcp;
[email protected]8b37a092012-10-18 21:53:491336 if (!reader_->ReadUInt16(&tcp->accumulated_number_of_lost_packets)) {
1337 set_detailed_error(
1338 "Unable to read accumulated number of lost packets.");
1339 return false;
1340 }
[email protected]8e01c062013-10-31 07:35:311341 // TODO(ianswett): Remove receive window, since it's constant.
[email protected]fee17f72013-02-03 07:47:411342 uint16 receive_window = 0;
1343 if (!reader_->ReadUInt16(&receive_window)) {
[email protected]8b37a092012-10-18 21:53:491344 set_detailed_error("Unable to read receive window.");
1345 return false;
1346 }
[email protected]fee17f72013-02-03 07:47:411347 // Simple bit packing, don't send the 4 least significant bits.
1348 tcp->receive_window = static_cast<QuicByteCount>(receive_window) << 4;
[email protected]8b37a092012-10-18 21:53:491349 break;
1350 }
1351 default:
[email protected]26f3f8e2012-12-13 21:07:191352 set_detailed_error("Illegal congestion feedback type.");
1353 DLOG(WARNING) << "Illegal congestion feedback type: "
1354 << frame->type;
[email protected]be24ab22012-10-22 03:01:521355 return RaiseError(QUIC_INVALID_FRAME_DATA);
[email protected]8b37a092012-10-18 21:53:491356 }
1357
[email protected]8b37a092012-10-18 21:53:491358 return true;
1359}
1360
[email protected]a57e0272013-04-26 07:31:471361bool QuicFramer::ProcessRstStreamFrame(QuicRstStreamFrame* frame) {
1362 if (!reader_->ReadUInt32(&frame->stream_id)) {
[email protected]8b37a092012-10-18 21:53:491363 set_detailed_error("Unable to read stream_id.");
1364 return false;
1365 }
1366
[email protected]431bb4fd2012-10-19 17:46:091367 uint32 error_code;
1368 if (!reader_->ReadUInt32(&error_code)) {
1369 set_detailed_error("Unable to read rst stream error code.");
[email protected]8b37a092012-10-18 21:53:491370 return false;
1371 }
[email protected]74bda142013-03-31 02:49:111372
1373 if (error_code >= QUIC_STREAM_LAST_ERROR ||
1374 error_code < QUIC_STREAM_NO_ERROR) {
1375 set_detailed_error("Invalid rst stream error code.");
1376 return false;
1377 }
1378
[email protected]a57e0272013-04-26 07:31:471379 frame->error_code = static_cast<QuicRstStreamErrorCode>(error_code);
[email protected]431bb4fd2012-10-19 17:46:091380
1381 StringPiece error_details;
1382 if (!reader_->ReadStringPiece16(&error_details)) {
1383 set_detailed_error("Unable to read rst stream error details.");
1384 return false;
1385 }
[email protected]a57e0272013-04-26 07:31:471386 frame->error_details = error_details.as_string();
[email protected]8b37a092012-10-18 21:53:491387
[email protected]8b37a092012-10-18 21:53:491388 return true;
1389}
1390
[email protected]a57e0272013-04-26 07:31:471391bool QuicFramer::ProcessConnectionCloseFrame(QuicConnectionCloseFrame* frame) {
[email protected]431bb4fd2012-10-19 17:46:091392 uint32 error_code;
1393 if (!reader_->ReadUInt32(&error_code)) {
1394 set_detailed_error("Unable to read connection close error code.");
[email protected]8b37a092012-10-18 21:53:491395 return false;
1396 }
[email protected]74bda142013-03-31 02:49:111397
1398 if (error_code >= QUIC_LAST_ERROR ||
1399 error_code < QUIC_NO_ERROR) {
1400 set_detailed_error("Invalid error code.");
1401 return false;
1402 }
1403
[email protected]a57e0272013-04-26 07:31:471404 frame->error_code = static_cast<QuicErrorCode>(error_code);
[email protected]431bb4fd2012-10-19 17:46:091405
1406 StringPiece error_details;
1407 if (!reader_->ReadStringPiece16(&error_details)) {
1408 set_detailed_error("Unable to read connection close error details.");
1409 return false;
1410 }
[email protected]a57e0272013-04-26 07:31:471411 frame->error_details = error_details.as_string();
[email protected]8b37a092012-10-18 21:53:491412
[email protected]8b37a092012-10-18 21:53:491413 return true;
1414}
1415
[email protected]a57e0272013-04-26 07:31:471416bool QuicFramer::ProcessGoAwayFrame(QuicGoAwayFrame* frame) {
[email protected]9db443912013-02-25 05:27:031417 uint32 error_code;
1418 if (!reader_->ReadUInt32(&error_code)) {
1419 set_detailed_error("Unable to read go away error code.");
1420 return false;
1421 }
[email protected]a57e0272013-04-26 07:31:471422 frame->error_code = static_cast<QuicErrorCode>(error_code);
[email protected]9db443912013-02-25 05:27:031423
[email protected]74bda142013-03-31 02:49:111424 if (error_code >= QUIC_LAST_ERROR ||
1425 error_code < QUIC_NO_ERROR) {
1426 set_detailed_error("Invalid error code.");
1427 return false;
1428 }
1429
[email protected]9db443912013-02-25 05:27:031430 uint32 stream_id;
1431 if (!reader_->ReadUInt32(&stream_id)) {
1432 set_detailed_error("Unable to read last good stream id.");
1433 return false;
1434 }
[email protected]a57e0272013-04-26 07:31:471435 frame->last_good_stream_id = static_cast<QuicStreamId>(stream_id);
[email protected]9db443912013-02-25 05:27:031436
1437 StringPiece reason_phrase;
1438 if (!reader_->ReadStringPiece16(&reason_phrase)) {
1439 set_detailed_error("Unable to read goaway reason.");
1440 return false;
1441 }
[email protected]a57e0272013-04-26 07:31:471442 frame->reason_phrase = reason_phrase.as_string();
[email protected]9db443912013-02-25 05:27:031443
[email protected]9db443912013-02-25 05:27:031444 return true;
1445}
1446
[email protected]74bda142013-03-31 02:49:111447// static
[email protected]5351cc4b2013-03-03 07:22:411448StringPiece QuicFramer::GetAssociatedDataFromEncryptedPacket(
[email protected]b064310782013-05-30 21:12:171449 const QuicEncryptedPacket& encrypted,
1450 QuicGuidLength guid_length,
[email protected]25c31dc2013-06-05 17:56:041451 bool includes_version,
1452 QuicSequenceNumberLength sequence_number_length) {
[email protected]5351cc4b2013-03-03 07:22:411453 return StringPiece(encrypted.data() + kStartOfHashData,
[email protected]b064310782013-05-30 21:12:171454 GetStartOfEncryptedData(
[email protected]25c31dc2013-06-05 17:56:041455 guid_length, includes_version, sequence_number_length)
1456 - kStartOfHashData);
[email protected]5351cc4b2013-03-03 07:22:411457}
1458
[email protected]8ba81212013-05-03 13:11:481459void QuicFramer::SetDecrypter(QuicDecrypter* decrypter) {
1460 DCHECK(alternative_decrypter_.get() == NULL);
[email protected]74bda142013-03-31 02:49:111461 decrypter_.reset(decrypter);
1462}
1463
[email protected]8ba81212013-05-03 13:11:481464void QuicFramer::SetAlternativeDecrypter(QuicDecrypter* decrypter,
1465 bool latch_once_used) {
1466 alternative_decrypter_.reset(decrypter);
1467 alternative_decrypter_latch_ = latch_once_used;
[email protected]74bda142013-03-31 02:49:111468}
1469
[email protected]8ba81212013-05-03 13:11:481470const QuicDecrypter* QuicFramer::decrypter() const {
1471 return decrypter_.get();
1472}
1473
1474const QuicDecrypter* QuicFramer::alternative_decrypter() const {
1475 return alternative_decrypter_.get();
1476}
1477
1478void QuicFramer::SetEncrypter(EncryptionLevel level,
1479 QuicEncrypter* encrypter) {
1480 DCHECK_GE(level, 0);
1481 DCHECK_LT(level, NUM_ENCRYPTION_LEVELS);
1482 encrypter_[level].reset(encrypter);
1483}
1484
1485const QuicEncrypter* QuicFramer::encrypter(EncryptionLevel level) const {
1486 DCHECK_GE(level, 0);
1487 DCHECK_LT(level, NUM_ENCRYPTION_LEVELS);
1488 DCHECK(encrypter_[level].get() != NULL);
1489 return encrypter_[level].get();
[email protected]74bda142013-03-31 02:49:111490}
1491
[email protected]2532de12013-05-09 12:29:331492void QuicFramer::SwapCryptersForTest(QuicFramer* other) {
1493 for (int i = ENCRYPTION_NONE; i < NUM_ENCRYPTION_LEVELS; i++) {
1494 encrypter_[i].swap(other->encrypter_[i]);
1495 }
1496 decrypter_.swap(other->decrypter_);
1497 alternative_decrypter_.swap(other->alternative_decrypter_);
1498
1499 const bool other_latch = other->alternative_decrypter_latch_;
1500 other->alternative_decrypter_latch_ = alternative_decrypter_latch_;
1501 alternative_decrypter_latch_ = other_latch;
1502}
1503
[email protected]9db443912013-02-25 05:27:031504QuicEncryptedPacket* QuicFramer::EncryptPacket(
[email protected]8ba81212013-05-03 13:11:481505 EncryptionLevel level,
[email protected]9db443912013-02-25 05:27:031506 QuicPacketSequenceNumber packet_sequence_number,
1507 const QuicPacket& packet) {
[email protected]8ba81212013-05-03 13:11:481508 DCHECK(encrypter_[level].get() != NULL);
1509
1510 scoped_ptr<QuicData> out(encrypter_[level]->EncryptPacket(
1511 packet_sequence_number, packet.AssociatedData(), packet.Plaintext()));
[email protected]8b37a092012-10-18 21:53:491512 if (out.get() == NULL) {
1513 RaiseError(QUIC_ENCRYPTION_FAILURE);
1514 return NULL;
1515 }
[email protected]5351cc4b2013-03-03 07:22:411516 StringPiece header_data = packet.BeforePlaintext();
1517 size_t len = header_data.length() + out->length();
[email protected]8b37a092012-10-18 21:53:491518 char* buffer = new char[len];
1519 // TODO(rch): eliminate this buffer copy by passing in a buffer to Encrypt().
[email protected]5351cc4b2013-03-03 07:22:411520 memcpy(buffer, header_data.data(), header_data.length());
1521 memcpy(buffer + header_data.length(), out->data(), out->length());
[email protected]8b37a092012-10-18 21:53:491522 return new QuicEncryptedPacket(buffer, len, true);
1523}
1524
1525size_t QuicFramer::GetMaxPlaintextSize(size_t ciphertext_size) {
[email protected]8ba81212013-05-03 13:11:481526 // In order to keep the code simple, we don't have the current encryption
[email protected]5dafdb62013-11-14 01:24:261527 // level to hand. Both the NullEncrypter and AES-GCM have a tag length of 12.
1528 size_t min_plaintext_size = ciphertext_size;
[email protected]8ba81212013-05-03 13:11:481529
[email protected]c244c5a12013-05-07 20:55:041530 for (int i = ENCRYPTION_NONE; i < NUM_ENCRYPTION_LEVELS; i++) {
[email protected]8ba81212013-05-03 13:11:481531 if (encrypter_[i].get() != NULL) {
1532 size_t size = encrypter_[i]->GetMaxPlaintextSize(ciphertext_size);
1533 if (size < min_plaintext_size) {
1534 min_plaintext_size = size;
1535 }
1536 }
1537 }
1538
1539 return min_plaintext_size;
[email protected]8b37a092012-10-18 21:53:491540}
1541
[email protected]25c31dc2013-06-05 17:56:041542bool QuicFramer::DecryptPayload(const QuicPacketHeader& header,
[email protected]9db443912013-02-25 05:27:031543 const QuicEncryptedPacket& packet) {
[email protected]8b37a092012-10-18 21:53:491544 StringPiece encrypted;
1545 if (!reader_->ReadStringPiece(&encrypted, reader_->BytesRemaining())) {
1546 return false;
1547 }
1548 DCHECK(decrypter_.get() != NULL);
[email protected]74bda142013-03-31 02:49:111549 decrypted_.reset(decrypter_->DecryptPacket(
[email protected]25c31dc2013-06-05 17:56:041550 header.packet_sequence_number,
1551 GetAssociatedDataFromEncryptedPacket(
1552 packet,
1553 header.public_header.guid_length,
1554 header.public_header.version_flag,
1555 header.public_header.sequence_number_length),
[email protected]5351cc4b2013-03-03 07:22:411556 encrypted));
[email protected]8ba81212013-05-03 13:11:481557 if (decrypted_.get() == NULL && alternative_decrypter_.get() != NULL) {
[email protected]8ba81212013-05-03 13:11:481558 decrypted_.reset(alternative_decrypter_->DecryptPacket(
[email protected]25c31dc2013-06-05 17:56:041559 header.packet_sequence_number,
1560 GetAssociatedDataFromEncryptedPacket(
1561 packet,
1562 header.public_header.guid_length,
1563 header.public_header.version_flag,
1564 header.public_header.sequence_number_length),
[email protected]74bda142013-03-31 02:49:111565 encrypted));
[email protected]8ba81212013-05-03 13:11:481566 if (decrypted_.get() != NULL) {
[email protected]8ba81212013-05-03 13:11:481567 if (alternative_decrypter_latch_) {
[email protected]8ba81212013-05-03 13:11:481568 // Switch to the alternative decrypter and latch so that we cannot
1569 // switch back.
1570 decrypter_.reset(alternative_decrypter_.release());
1571 } else {
[email protected]8ba81212013-05-03 13:11:481572 // Switch the alternative decrypter so that we use it first next time.
1573 decrypter_.swap(alternative_decrypter_);
1574 }
1575 }
[email protected]74bda142013-03-31 02:49:111576 }
[email protected]8ba81212013-05-03 13:11:481577
[email protected]8b37a092012-10-18 21:53:491578 if (decrypted_.get() == NULL) {
1579 return false;
1580 }
1581
1582 reader_.reset(new QuicDataReader(decrypted_->data(), decrypted_->length()));
1583 return true;
1584}
1585
[email protected]8e01c062013-10-31 07:35:311586size_t QuicFramer::GetAckFrameSize(
1587 const QuicAckFrame& ack,
1588 QuicSequenceNumberLength sequence_number_length) {
[email protected]31ae854842013-11-27 00:05:461589 AckFrameInfo ack_info = GetAckFrameInfo(ack);
1590 QuicSequenceNumberLength largest_observed_length =
1591 GetMinSequenceNumberLength(ack.received_info.largest_observed);
1592 QuicSequenceNumberLength missing_sequence_number_length =
1593 GetMinSequenceNumberLength(ack_info.max_delta);
[email protected]8e01c062013-10-31 07:35:311594
[email protected]31ae854842013-11-27 00:05:461595 return GetMinAckFrameSize(quic_version_,
1596 sequence_number_length,
1597 largest_observed_length) +
1598 (ack_info.nack_ranges.empty() ? 0 : kNumberOfMissingPacketsSize) +
1599 ack_info.nack_ranges.size() *
1600 (missing_sequence_number_length + PACKET_1BYTE_SEQUENCE_NUMBER);
[email protected]8e01c062013-10-31 07:35:311601}
1602
1603size_t QuicFramer::ComputeFrameLength(
1604 const QuicFrame& frame,
1605 bool last_frame_in_packet,
1606 QuicSequenceNumberLength sequence_number_length) {
[email protected]be24ab22012-10-22 03:01:521607 switch (frame.type) {
1608 case STREAM_FRAME:
[email protected]3e60db82013-08-05 19:43:061609 return GetMinStreamFrameSize(quic_version_,
1610 frame.stream_frame->stream_id,
[email protected]f62262b2013-07-05 20:57:301611 frame.stream_frame->offset,
[email protected]3e60db82013-08-05 19:43:061612 last_frame_in_packet) +
[email protected]5dafdb62013-11-14 01:24:261613 frame.stream_frame->data.TotalBufferSize();
[email protected]be24ab22012-10-22 03:01:521614 case ACK_FRAME: {
[email protected]8e01c062013-10-31 07:35:311615 return GetAckFrameSize(*frame.ack_frame, sequence_number_length);
[email protected]26f3f8e2012-12-13 21:07:191616 }
1617 case CONGESTION_FEEDBACK_FRAME: {
[email protected]5351cc4b2013-03-03 07:22:411618 size_t len = kQuicFrameTypeSize;
[email protected]26f3f8e2012-12-13 21:07:191619 const QuicCongestionFeedbackFrame& congestion_feedback =
1620 *frame.congestion_feedback_frame;
[email protected]9db443912013-02-25 05:27:031621 len += 1; // Congestion feedback type.
[email protected]26f3f8e2012-12-13 21:07:191622
1623 switch (congestion_feedback.type) {
[email protected]7884ecad2012-12-14 22:55:151624 case kInterArrival: {
1625 const CongestionFeedbackMessageInterArrival& inter_arrival =
1626 congestion_feedback.inter_arrival;
[email protected]3c5f4a732013-01-12 16:45:341627 len += 2;
[email protected]9db443912013-02-25 05:27:031628 len += 1; // Number received packets.
[email protected]7884ecad2012-12-14 22:55:151629 if (inter_arrival.received_packet_times.size() > 0) {
[email protected]25c31dc2013-06-05 17:56:041630 len += PACKET_6BYTE_SEQUENCE_NUMBER; // Smallest received.
[email protected]9db443912013-02-25 05:27:031631 len += 8; // Time.
[email protected]7884ecad2012-12-14 22:55:151632 // 2 bytes per sequence number delta plus 4 bytes per delta time.
[email protected]25c31dc2013-06-05 17:56:041633 len += PACKET_6BYTE_SEQUENCE_NUMBER *
[email protected]5351cc4b2013-03-03 07:22:411634 (inter_arrival.received_packet_times.size() - 1);
[email protected]7884ecad2012-12-14 22:55:151635 }
[email protected]8b37a092012-10-18 21:53:491636 break;
[email protected]7884ecad2012-12-14 22:55:151637 }
[email protected]8b37a092012-10-18 21:53:491638 case kFixRate:
1639 len += 4;
1640 break;
1641 case kTCP:
1642 len += 4;
1643 break;
1644 default:
1645 set_detailed_error("Illegal feedback type.");
[email protected]3e5fed12013-11-22 22:21:411646 DVLOG(1) << "Illegal feedback type: " << congestion_feedback.type;
[email protected]8b37a092012-10-18 21:53:491647 break;
1648 }
[email protected]5351cc4b2013-03-03 07:22:411649 return len;
[email protected]8b37a092012-10-18 21:53:491650 }
[email protected]be24ab22012-10-22 03:01:521651 case RST_STREAM_FRAME:
[email protected]5351cc4b2013-03-03 07:22:411652 return GetMinRstStreamFrameSize() +
1653 frame.rst_stream_frame->error_details.size();
[email protected]31ae854842013-11-27 00:05:461654 case CONNECTION_CLOSE_FRAME:
1655 return GetMinConnectionCloseFrameSize() +
1656 frame.connection_close_frame->error_details.size();
[email protected]9db443912013-02-25 05:27:031657 case GOAWAY_FRAME:
[email protected]5351cc4b2013-03-03 07:22:411658 return GetMinGoAwayFrameSize() + frame.goaway_frame->reason_phrase.size();
1659 case PADDING_FRAME:
1660 DCHECK(false);
1661 return 0;
1662 case NUM_FRAME_TYPES:
1663 DCHECK(false);
1664 return 0;
[email protected]8b37a092012-10-18 21:53:491665 }
[email protected]ccc66e8a2013-03-26 08:26:141666
1667 // Not reachable, but some Chrome compilers can't figure that out. *sigh*
[email protected]5351cc4b2013-03-03 07:22:411668 DCHECK(false);
1669 return 0;
[email protected]8b37a092012-10-18 21:53:491670}
1671
[email protected]3e60db82013-08-05 19:43:061672bool QuicFramer::AppendTypeByte(const QuicFrame& frame,
1673 bool last_frame_in_packet,
1674 QuicDataWriter* writer) {
[email protected]3e60db82013-08-05 19:43:061675 uint8 type_byte = 0;
1676 switch (frame.type) {
1677 case STREAM_FRAME: {
1678 if (frame.stream_frame == NULL) {
1679 LOG(DFATAL) << "Failed to append STREAM frame with no stream_frame.";
1680 }
1681 // Fin bit.
1682 type_byte |= frame.stream_frame->fin ? kQuicStreamFinMask : 0;
1683
1684 // Data Length bit.
1685 type_byte <<= kQuicStreamDataLengthShift;
1686 type_byte |= last_frame_in_packet ? 0 : kQuicStreamDataLengthMask;
1687
1688 // Offset 3 bits.
1689 type_byte <<= kQuicStreamOffsetShift;
1690 const size_t offset_len = GetStreamOffsetSize(frame.stream_frame->offset);
1691 if (offset_len > 0) {
1692 type_byte |= offset_len - 1;
1693 }
1694
1695 // stream id 2 bits.
1696 type_byte <<= kQuicStreamIdShift;
1697 type_byte |= GetStreamIdSize(frame.stream_frame->stream_id) - 1;
[email protected]8f547ea2013-10-24 05:55:041698 type_byte |= kQuicFrameTypeStreamMask; // Set Stream Frame Type to 1.
[email protected]3e60db82013-08-05 19:43:061699 break;
1700 }
[email protected]31ae854842013-11-27 00:05:461701 case ACK_FRAME:
1702 return true;
[email protected]3e60db82013-08-05 19:43:061703 case CONGESTION_FEEDBACK_FRAME: {
1704 // TODO(ianswett): Use extra 5 bits in the congestion feedback framing.
[email protected]8f547ea2013-10-24 05:55:041705 type_byte = kQuicFrameTypeCongestionFeedbackMask;
[email protected]3e60db82013-08-05 19:43:061706 break;
1707 }
1708 default:
[email protected]97cf3022013-09-05 14:30:161709 type_byte = frame.type;
[email protected]3e60db82013-08-05 19:43:061710 break;
1711 }
1712
1713 return writer->WriteUInt8(type_byte);
1714}
1715
[email protected]86a318d2013-01-23 21:16:041716// static
[email protected]c995c572013-01-18 05:43:201717bool QuicFramer::AppendPacketSequenceNumber(
[email protected]25c31dc2013-06-05 17:56:041718 QuicSequenceNumberLength sequence_number_length,
[email protected]c995c572013-01-18 05:43:201719 QuicPacketSequenceNumber packet_sequence_number,
1720 QuicDataWriter* writer) {
[email protected]86a318d2013-01-23 21:16:041721 // Ensure the entire sequence number can be written.
[email protected]25c31dc2013-06-05 17:56:041722 if (writer->capacity() - writer->length() <
[email protected]d6ce2eb2013-06-11 13:36:571723 static_cast<size_t>(sequence_number_length)) {
[email protected]86a318d2013-01-23 21:16:041724 return false;
1725 }
[email protected]25c31dc2013-06-05 17:56:041726 switch (sequence_number_length) {
1727 case PACKET_1BYTE_SEQUENCE_NUMBER:
1728 return writer->WriteUInt8(
1729 packet_sequence_number & k1ByteSequenceNumberMask);
1730 break;
1731 case PACKET_2BYTE_SEQUENCE_NUMBER:
1732 return writer->WriteUInt16(
1733 packet_sequence_number & k2ByteSequenceNumberMask);
1734 break;
1735 case PACKET_4BYTE_SEQUENCE_NUMBER:
1736 return writer->WriteUInt32(
1737 packet_sequence_number & k4ByteSequenceNumberMask);
1738 break;
1739 case PACKET_6BYTE_SEQUENCE_NUMBER:
1740 return writer->WriteUInt48(
1741 packet_sequence_number & k6ByteSequenceNumberMask);
1742 break;
1743 default:
1744 NOTREACHED() << "sequence_number_length: " << sequence_number_length;
1745 return false;
1746 }
[email protected]c995c572013-01-18 05:43:201747}
1748
[email protected]be24ab22012-10-22 03:01:521749bool QuicFramer::AppendStreamFramePayload(
1750 const QuicStreamFrame& frame,
[email protected]3e60db82013-08-05 19:43:061751 bool last_frame_in_packet,
1752 QuicDataWriter* writer) {
1753 if (!writer->WriteBytes(&frame.stream_id, GetStreamIdSize(frame.stream_id))) {
1754 return false;
1755 }
1756 if (!writer->WriteBytes(&frame.offset, GetStreamOffsetSize(frame.offset))) {
1757 return false;
1758 }
1759 if (!last_frame_in_packet) {
[email protected]5dafdb62013-11-14 01:24:261760 if (!writer->WriteUInt16(frame.data.TotalBufferSize())) {
[email protected]3e60db82013-08-05 19:43:061761 return false;
1762 }
1763 }
[email protected]5dafdb62013-11-14 01:24:261764
1765 if (!writer->WriteIOVector(frame.data)) {
[email protected]3e60db82013-08-05 19:43:061766 return false;
1767 }
1768 return true;
1769}
1770
[email protected]691f45a982013-11-19 10:52:041771// static
1772bool QuicFramer::HasVersionFlag(const QuicEncryptedPacket& packet) {
1773 return packet.length() > 0 &&
1774 (packet.data()[0] & PACKET_PUBLIC_FLAGS_VERSION) != 0;
1775}
1776
1777// static
[email protected]48697d8a2013-01-15 19:42:241778QuicPacketSequenceNumber QuicFramer::CalculateLargestObserved(
[email protected]9db443912013-02-25 05:27:031779 const SequenceNumberSet& missing_packets,
1780 SequenceNumberSet::const_iterator largest_written) {
1781 SequenceNumberSet::const_iterator it = largest_written;
[email protected]610a7e942012-12-18 00:21:391782 QuicPacketSequenceNumber previous_missing = *it;
1783 ++it;
1784
[email protected]aa07e442013-01-11 08:38:151785 // See if the next thing is a gap in the missing packets: if it's a
1786 // non-missing packet we can return it.
1787 if (it != missing_packets.end() && previous_missing + 1 != *it) {
[email protected]7759f852013-01-25 15:51:051788 return *it - 1;
1789 }
[email protected]610a7e942012-12-18 00:21:391790
[email protected]48697d8a2013-01-15 19:42:241791 // Otherwise return the largest missing packet, as indirectly observed.
1792 return *largest_written;
[email protected]610a7e942012-12-18 00:21:391793}
1794
[email protected]752fbe52013-10-14 08:35:321795void QuicFramer::set_version(const QuicVersion version) {
1796 DCHECK(IsSupportedVersion(version));
[email protected]752fbe52013-10-14 08:35:321797 quic_version_ = version;
1798}
1799
[email protected]8e01c062013-10-31 07:35:311800bool QuicFramer::AppendAckFramePayloadAndTypeByte(
1801 const QuicPacketHeader& header,
1802 const QuicAckFrame& frame,
1803 QuicDataWriter* writer) {
1804 AckFrameInfo ack_info = GetAckFrameInfo(frame);
1805 QuicPacketSequenceNumber ack_largest_observed =
1806 frame.received_info.largest_observed;
1807 QuicSequenceNumberLength largest_observed_length =
1808 GetMinSequenceNumberLength(ack_largest_observed);
1809 QuicSequenceNumberLength missing_sequence_number_length =
1810 GetMinSequenceNumberLength(ack_info.max_delta);
1811 // Determine whether we need to truncate ranges.
1812 size_t available_range_bytes = writer->capacity() - writer->length() -
1813 GetMinAckFrameSize(quic_version_,
1814 header.public_header.sequence_number_length,
1815 largest_observed_length);
1816 size_t max_num_ranges = available_range_bytes /
1817 (missing_sequence_number_length + PACKET_1BYTE_SEQUENCE_NUMBER);
1818 max_num_ranges =
1819 min(static_cast<size_t>(numeric_limits<uint8>::max()), max_num_ranges);
1820 bool truncated = ack_info.nack_ranges.size() > max_num_ranges;
[email protected]457d6952013-12-13 09:24:581821 DVLOG_IF(1, truncated) << "Truncating ack from "
1822 << ack_info.nack_ranges.size() << " ranges to "
1823 << max_num_ranges;
[email protected]8e01c062013-10-31 07:35:311824
1825 // Write out the type byte by setting the low order bits and doing shifts
1826 // to make room for the next bit flags to be set.
1827 // Whether there are any nacks.
1828 uint8 type_byte = ack_info.nack_ranges.empty() ? 0 : kQuicHasNacksMask;
1829
1830 // truncating bit.
1831 type_byte <<= kQuicAckTruncatedShift;
1832 type_byte |= truncated ? kQuicAckTruncatedMask : 0;
1833
1834 // Largest observed sequence number length.
1835 type_byte <<= kQuicSequenceNumberLengthShift;
1836 type_byte |= GetSequenceNumberFlags(largest_observed_length);
1837
1838 // Missing sequence number length.
1839 type_byte <<= kQuicSequenceNumberLengthShift;
1840 type_byte |= GetSequenceNumberFlags(missing_sequence_number_length);
1841
1842 type_byte |= kQuicFrameTypeAckMask;
1843
1844 if (!writer->WriteUInt8(type_byte)) {
1845 return false;
1846 }
1847
1848 // TODO(satyamshekhar): Decide how often we really should send this
1849 // entropy_hash update.
1850 if (!writer->WriteUInt8(frame.sent_info.entropy_hash)) {
1851 return false;
1852 }
1853
1854 DCHECK_GE(header.packet_sequence_number, frame.sent_info.least_unacked);
1855 const QuicPacketSequenceNumber least_unacked_delta =
1856 header.packet_sequence_number - frame.sent_info.least_unacked;
1857 if (!AppendPacketSequenceNumber(header.public_header.sequence_number_length,
1858 least_unacked_delta, writer)) {
1859 return false;
1860 }
1861
1862 const ReceivedPacketInfo& received_info = frame.received_info;
1863 QuicPacketEntropyHash ack_entropy_hash = received_info.entropy_hash;
1864 NackRangeMap::reverse_iterator ack_iter = ack_info.nack_ranges.rbegin();
1865 if (truncated) {
1866 // Skip the nack ranges which the truncated ack won't include and set
1867 // a correct largest observed for the truncated ack.
1868 for (size_t i = 1; i < (ack_info.nack_ranges.size() - max_num_ranges);
1869 ++i) {
1870 ++ack_iter;
1871 }
1872 // If the last range is followed by acks, include them.
1873 // If the last range is followed by another range, specify the end of the
1874 // range as the largest_observed.
1875 ack_largest_observed = ack_iter->first - 1;
1876 // Also update the entropy so it matches the largest observed.
1877 ack_entropy_hash = entropy_calculator_->EntropyHash(ack_largest_observed);
1878 ++ack_iter;
1879 }
1880
1881 if (!writer->WriteUInt8(ack_entropy_hash)) {
1882 return false;
1883 }
1884
1885 if (!AppendPacketSequenceNumber(largest_observed_length,
1886 ack_largest_observed, writer)) {
1887 return false;
1888 }
1889
1890 uint64 delta_time_largest_observed_us = kUFloat16MaxValue;
1891 if (!received_info.delta_time_largest_observed.IsInfinite()) {
[email protected]0ac0c5b2013-11-20 05:55:581892 DCHECK_LE(0u,
1893 frame.received_info.delta_time_largest_observed.ToMicroseconds());
[email protected]8e01c062013-10-31 07:35:311894 delta_time_largest_observed_us =
1895 received_info.delta_time_largest_observed.ToMicroseconds();
1896 }
1897
1898 if (!writer->WriteUFloat16(delta_time_largest_observed_us)) {
1899 return false;
1900 }
1901
1902 if (ack_info.nack_ranges.empty()) {
1903 return true;
1904 }
1905
1906 const uint8 num_missing_ranges =
1907 min(ack_info.nack_ranges.size(), max_num_ranges);
1908 if (!writer->WriteBytes(&num_missing_ranges, 1)) {
1909 return false;
1910 }
1911
1912 int num_ranges_written = 0;
1913 QuicPacketSequenceNumber last_sequence_written = ack_largest_observed;
1914 for (; ack_iter != ack_info.nack_ranges.rend(); ++ack_iter) {
1915 // Calculate the delta to the last number in the range.
1916 QuicPacketSequenceNumber missing_delta =
1917 last_sequence_written - (ack_iter->first + ack_iter->second);
1918 if (!AppendPacketSequenceNumber(missing_sequence_number_length,
1919 missing_delta, writer)) {
1920 return false;
1921 }
1922 if (!AppendPacketSequenceNumber(PACKET_1BYTE_SEQUENCE_NUMBER,
1923 ack_iter->second, writer)) {
1924 return false;
1925 }
1926 // Subtract 1 so a missing_delta of 0 means an adjacent range.
1927 last_sequence_written = ack_iter->first - 1;
1928 ++num_ranges_written;
1929 }
1930
1931 DCHECK_EQ(num_missing_ranges, num_ranges_written);
1932 return true;
1933}
1934
[email protected]26f3f8e2012-12-13 21:07:191935bool QuicFramer::AppendQuicCongestionFeedbackFramePayload(
1936 const QuicCongestionFeedbackFrame& frame,
1937 QuicDataWriter* writer) {
1938 if (!writer->WriteBytes(&frame.type, 1)) {
[email protected]8b37a092012-10-18 21:53:491939 return false;
1940 }
1941
[email protected]26f3f8e2012-12-13 21:07:191942 switch (frame.type) {
[email protected]8b37a092012-10-18 21:53:491943 case kInterArrival: {
1944 const CongestionFeedbackMessageInterArrival& inter_arrival =
[email protected]26f3f8e2012-12-13 21:07:191945 frame.inter_arrival;
[email protected]8b37a092012-10-18 21:53:491946 if (!writer->WriteUInt16(
1947 inter_arrival.accumulated_number_of_lost_packets)) {
1948 return false;
1949 }
[email protected]7884ecad2012-12-14 22:55:151950 DCHECK_GE(numeric_limits<uint8>::max(),
1951 inter_arrival.received_packet_times.size());
1952 if (inter_arrival.received_packet_times.size() >
1953 numeric_limits<uint8>::max()) {
1954 return false;
1955 }
[email protected]7884ecad2012-12-14 22:55:151956 // TODO(ianswett): Make num_received_packets a varint.
1957 uint8 num_received_packets =
1958 inter_arrival.received_packet_times.size();
1959 if (!writer->WriteBytes(&num_received_packets, 1)) {
1960 return false;
1961 }
1962 if (num_received_packets > 0) {
1963 TimeMap::const_iterator it =
1964 inter_arrival.received_packet_times.begin();
1965
1966 QuicPacketSequenceNumber lowest_sequence = it->first;
[email protected]25c31dc2013-06-05 17:56:041967 if (!AppendPacketSequenceNumber(PACKET_6BYTE_SEQUENCE_NUMBER,
1968 lowest_sequence, writer)) {
[email protected]7884ecad2012-12-14 22:55:151969 return false;
1970 }
1971
1972 QuicTime lowest_time = it->second;
[email protected]74bda142013-03-31 02:49:111973 if (!writer->WriteUInt64(
1974 lowest_time.Subtract(creation_time_).ToMicroseconds())) {
[email protected]7884ecad2012-12-14 22:55:151975 return false;
1976 }
1977
1978 for (++it; it != inter_arrival.received_packet_times.end(); ++it) {
1979 QuicPacketSequenceNumber sequence_delta = it->first - lowest_sequence;
1980 DCHECK_GE(numeric_limits<uint16>::max(), sequence_delta);
1981 if (sequence_delta > numeric_limits<uint16>::max()) {
1982 return false;
1983 }
1984 if (!writer->WriteUInt16(static_cast<uint16>(sequence_delta))) {
1985 return false;
1986 }
1987
1988 int32 time_delta_us =
1989 it->second.Subtract(lowest_time).ToMicroseconds();
1990 if (!writer->WriteBytes(&time_delta_us, sizeof(time_delta_us))) {
1991 return false;
1992 }
1993 }
1994 }
[email protected]8b37a092012-10-18 21:53:491995 break;
1996 }
1997 case kFixRate: {
1998 const CongestionFeedbackMessageFixRate& fix_rate =
[email protected]26f3f8e2012-12-13 21:07:191999 frame.fix_rate;
[email protected]fee17f72013-02-03 07:47:412000 if (!writer->WriteUInt32(fix_rate.bitrate.ToBytesPerSecond())) {
[email protected]8b37a092012-10-18 21:53:492001 return false;
2002 }
2003 break;
2004 }
2005 case kTCP: {
[email protected]26f3f8e2012-12-13 21:07:192006 const CongestionFeedbackMessageTCP& tcp = frame.tcp;
[email protected]fee17f72013-02-03 07:47:412007 DCHECK_LE(tcp.receive_window, 1u << 20);
2008 // Simple bit packing, don't send the 4 least significant bits.
2009 uint16 receive_window = static_cast<uint16>(tcp.receive_window >> 4);
[email protected]8b37a092012-10-18 21:53:492010 if (!writer->WriteUInt16(tcp.accumulated_number_of_lost_packets)) {
2011 return false;
2012 }
[email protected]fee17f72013-02-03 07:47:412013 if (!writer->WriteUInt16(receive_window)) {
[email protected]8b37a092012-10-18 21:53:492014 return false;
2015 }
2016 break;
2017 }
2018 default:
2019 return false;
2020 }
2021
2022 return true;
2023}
2024
[email protected]be24ab22012-10-22 03:01:522025bool QuicFramer::AppendRstStreamFramePayload(
2026 const QuicRstStreamFrame& frame,
[email protected]8b37a092012-10-18 21:53:492027 QuicDataWriter* writer) {
[email protected]be24ab22012-10-22 03:01:522028 if (!writer->WriteUInt32(frame.stream_id)) {
[email protected]8b37a092012-10-18 21:53:492029 return false;
2030 }
[email protected]8b37a092012-10-18 21:53:492031
[email protected]be24ab22012-10-22 03:01:522032 uint32 error_code = static_cast<uint32>(frame.error_code);
[email protected]431bb4fd2012-10-19 17:46:092033 if (!writer->WriteUInt32(error_code)) {
2034 return false;
2035 }
2036
[email protected]be24ab22012-10-22 03:01:522037 if (!writer->WriteStringPiece16(frame.error_details)) {
[email protected]8b37a092012-10-18 21:53:492038 return false;
2039 }
2040 return true;
2041}
2042
[email protected]be24ab22012-10-22 03:01:522043bool QuicFramer::AppendConnectionCloseFramePayload(
2044 const QuicConnectionCloseFrame& frame,
[email protected]8b37a092012-10-18 21:53:492045 QuicDataWriter* writer) {
[email protected]be24ab22012-10-22 03:01:522046 uint32 error_code = static_cast<uint32>(frame.error_code);
[email protected]431bb4fd2012-10-19 17:46:092047 if (!writer->WriteUInt32(error_code)) {
2048 return false;
2049 }
[email protected]be24ab22012-10-22 03:01:522050 if (!writer->WriteStringPiece16(frame.error_details)) {
[email protected]8b37a092012-10-18 21:53:492051 return false;
2052 }
[email protected]8b37a092012-10-18 21:53:492053 return true;
2054}
2055
[email protected]9db443912013-02-25 05:27:032056bool QuicFramer::AppendGoAwayFramePayload(const QuicGoAwayFrame& frame,
2057 QuicDataWriter* writer) {
2058 uint32 error_code = static_cast<uint32>(frame.error_code);
2059 if (!writer->WriteUInt32(error_code)) {
2060 return false;
2061 }
2062 uint32 stream_id = static_cast<uint32>(frame.last_good_stream_id);
2063 if (!writer->WriteUInt32(stream_id)) {
2064 return false;
2065 }
2066 if (!writer->WriteStringPiece16(frame.reason_phrase)) {
2067 return false;
2068 }
2069 return true;
2070}
2071
[email protected]8b37a092012-10-18 21:53:492072bool QuicFramer::RaiseError(QuicErrorCode error) {
[email protected]3e5fed12013-11-22 22:21:412073 DVLOG(1) << detailed_error_;
[email protected]8b37a092012-10-18 21:53:492074 set_error(error);
2075 visitor_->OnError(this);
2076 reader_.reset(NULL);
2077 return false;
2078}
2079
2080} // namespace net