Index: net/quic/core/quic_frames.h |
diff --git a/net/quic/core/quic_frames.h b/net/quic/core/quic_frames.h |
deleted file mode 100644 |
index 7a8f919f0fdd9f810478268d08aa530caa31aeb0..0000000000000000000000000000000000000000 |
--- a/net/quic/core/quic_frames.h |
+++ /dev/null |
@@ -1,391 +0,0 @@ |
-// Copyright (c) 2016 The Chromium Authors. All rights reserved. |
-// Use of this source code is governed by a BSD-style license that can be |
-// found in the LICENSE file. |
- |
-#ifndef NET_QUIC_CORE_QUIC_FRAMES_H_ |
-#define NET_QUIC_CORE_QUIC_FRAMES_H_ |
- |
-#include <cstdint> |
-#include <limits> |
-#include <memory> |
-#include <string> |
-#include <vector> |
- |
-#include "base/logging.h" |
-#include "base/macros.h" |
-#include "base/strings/string_piece.h" |
-#include "net/quic/core/interval_set.h" |
-#include "net/quic/core/quic_buffer_allocator.h" |
-#include "net/quic/core/quic_constants.h" |
-#include "net/quic/core/quic_error_codes.h" |
-#include "net/quic/core/quic_time.h" |
-#include "net/quic/core/quic_types.h" |
-#include "net/quic/core/quic_versions.h" |
- |
-namespace net { |
- |
-// A padding frame contains no payload. |
-struct NET_EXPORT_PRIVATE QuicPaddingFrame { |
- QuicPaddingFrame() : num_padding_bytes(-1) {} |
- explicit QuicPaddingFrame(int num_padding_bytes) |
- : num_padding_bytes(num_padding_bytes) {} |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<(std::ostream& os, |
- const QuicPaddingFrame& s); |
- |
- // -1: full padding to the end of a max-sized packet |
- // otherwise: only pad up to num_padding_bytes bytes |
- int num_padding_bytes; |
-}; |
- |
-// A ping frame contains no payload, though it is retransmittable, |
-// and ACK'd just like other normal frames. |
-struct NET_EXPORT_PRIVATE QuicPingFrame {}; |
- |
-// A path MTU discovery frame contains no payload and is serialized as a ping |
-// frame. |
-struct NET_EXPORT_PRIVATE QuicMtuDiscoveryFrame {}; |
- |
-// Deleter for stream buffers. Copyable to support platforms where the deleter |
-// of a unique_ptr must be copyable. Otherwise it would be nice for this to be |
-// move-only. |
-class NET_EXPORT_PRIVATE StreamBufferDeleter { |
- public: |
- StreamBufferDeleter() : allocator_(nullptr) {} |
- explicit StreamBufferDeleter(QuicBufferAllocator* allocator) |
- : allocator_(allocator) {} |
- |
- // Deletes |buffer| using |allocator_|. |
- void operator()(char* buffer) const; |
- |
- private: |
- // Not owned; must be valid so long as the buffer stored in the unique_ptr |
- // that owns |this| is valid. |
- QuicBufferAllocator* allocator_; |
-}; |
- |
-using UniqueStreamBuffer = std::unique_ptr<char[], StreamBufferDeleter>; |
- |
-// Allocates memory of size |size| using |allocator| for a QUIC stream buffer. |
-NET_EXPORT_PRIVATE UniqueStreamBuffer |
-NewStreamBuffer(QuicBufferAllocator* allocator, size_t size); |
- |
-struct NET_EXPORT_PRIVATE QuicStreamFrame { |
- QuicStreamFrame(); |
- QuicStreamFrame(QuicStreamId stream_id, |
- bool fin, |
- QuicStreamOffset offset, |
- base::StringPiece data); |
- QuicStreamFrame(QuicStreamId stream_id, |
- bool fin, |
- QuicStreamOffset offset, |
- QuicPacketLength data_length, |
- UniqueStreamBuffer buffer); |
- ~QuicStreamFrame(); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<(std::ostream& os, |
- const QuicStreamFrame& s); |
- |
- QuicStreamId stream_id; |
- bool fin; |
- QuicPacketLength data_length; |
- const char* data_buffer; |
- QuicStreamOffset offset; // Location of this data in the stream. |
- // nullptr when the QuicStreamFrame is received, and non-null when sent. |
- UniqueStreamBuffer buffer; |
- |
- private: |
- QuicStreamFrame(QuicStreamId stream_id, |
- bool fin, |
- QuicStreamOffset offset, |
- const char* data_buffer, |
- QuicPacketLength data_length, |
- UniqueStreamBuffer buffer); |
- |
- DISALLOW_COPY_AND_ASSIGN(QuicStreamFrame); |
-}; |
-static_assert(sizeof(QuicStreamFrame) <= 64, |
- "Keep the QuicStreamFrame size to a cacheline."); |
- |
-typedef std::vector<std::pair<QuicPacketNumber, QuicTime>> PacketTimeVector; |
- |
-struct NET_EXPORT_PRIVATE QuicStopWaitingFrame { |
- QuicStopWaitingFrame(); |
- ~QuicStopWaitingFrame(); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<( |
- std::ostream& os, |
- const QuicStopWaitingFrame& s); |
- // Path which this stop waiting frame belongs to. |
- QuicPathId path_id; |
- // The lowest packet we've sent which is unacked, and we expect an ack for. |
- QuicPacketNumber least_unacked; |
-}; |
- |
-// A sequence of packet numbers where each number is unique. Intended to be used |
-// in a sliding window fashion, where smaller old packet numbers are removed and |
-// larger new packet numbers are added, with the occasional random access. |
-class NET_EXPORT_PRIVATE PacketNumberQueue { |
- public: |
- using const_iterator = IntervalSet<QuicPacketNumber>::const_iterator; |
- using const_reverse_iterator = |
- IntervalSet<QuicPacketNumber>::const_reverse_iterator; |
- |
- PacketNumberQueue(); |
- PacketNumberQueue(const PacketNumberQueue& other); |
- PacketNumberQueue(PacketNumberQueue&& other); |
- ~PacketNumberQueue(); |
- |
- PacketNumberQueue& operator=(const PacketNumberQueue& other); |
- PacketNumberQueue& operator=(PacketNumberQueue&& other); |
- |
- // Adds |packet_number| to the set of packets in the queue. |
- void Add(QuicPacketNumber packet_number); |
- |
- // Adds packets between [lower, higher) to the set of packets in the queue. It |
- // is undefined behavior to call this with |higher| < |lower|. |
- void Add(QuicPacketNumber lower, QuicPacketNumber higher); |
- |
- // Removes |packet_number| from the set of packets in the queue. |
- void Remove(QuicPacketNumber packet_number); |
- |
- // Removes packets numbers between [lower, higher) to the set of packets in |
- // the queue. It is undefined behavior to call this with |higher| < |lower|. |
- void Remove(QuicPacketNumber lower, QuicPacketNumber higher); |
- |
- // Removes packets with values less than |higher| from the set of packets in |
- // the queue. Returns true if packets were removed. |
- bool RemoveUpTo(QuicPacketNumber higher); |
- |
- // Mutates packet number set so that it contains only those packet numbers |
- // from minimum to maximum packet number not currently in the set. Do nothing |
- // if packet number set is empty. |
- void Complement(); |
- |
- // Returns true if the queue contains |packet_number|. |
- bool Contains(QuicPacketNumber packet_number) const; |
- |
- // Returns true if the queue is empty. |
- bool Empty() const; |
- |
- // Returns the minimum packet number stored in the queue. It is undefined |
- // behavior to call this if the queue is empty. |
- QuicPacketNumber Min() const; |
- |
- // Returns the maximum packet number stored in the queue. It is undefined |
- // behavior to call this if the queue is empty. |
- QuicPacketNumber Max() const; |
- |
- // Returns the number of unique packets stored in the queue. Inefficient; only |
- // exposed for testing. |
- size_t NumPacketsSlow() const; |
- |
- // Returns the number of disjoint packet number intervals contained in the |
- // queue. |
- size_t NumIntervals() const; |
- |
- // Returns the length of last interval. |
- QuicPacketNumber LastIntervalLength() const; |
- |
- // Returns iterators over the packet number intervals. |
- const_iterator begin() const; |
- const_iterator end() const; |
- const_reverse_iterator rbegin() const; |
- const_reverse_iterator rend() const; |
- const_iterator lower_bound(QuicPacketNumber packet_number) const; |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<( |
- std::ostream& os, |
- const PacketNumberQueue& q); |
- |
- private: |
- IntervalSet<QuicPacketNumber> packet_number_intervals_; |
-}; |
- |
-struct NET_EXPORT_PRIVATE QuicAckFrame { |
- QuicAckFrame(); |
- QuicAckFrame(const QuicAckFrame& other); |
- ~QuicAckFrame(); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<(std::ostream& os, |
- const QuicAckFrame& s); |
- |
- // The highest packet number we've observed from the peer. |
- QuicPacketNumber largest_observed; |
- |
- // Time elapsed since largest_observed was received until this Ack frame was |
- // sent. |
- QuicTime::Delta ack_delay_time; |
- |
- // Vector of <packet_number, time> for when packets arrived. |
- PacketTimeVector received_packet_times; |
- |
- // Set of packets. |
- PacketNumberQueue packets; |
- |
- // Path which this ack belongs to. |
- QuicPathId path_id; |
-}; |
- |
-// True if the packet number is greater than largest_observed or is listed |
-// as missing. |
-// Always returns false for packet numbers less than least_unacked. |
-NET_EXPORT_PRIVATE bool IsAwaitingPacket( |
- const QuicAckFrame& ack_frame, |
- QuicPacketNumber packet_number, |
- QuicPacketNumber peer_least_packet_awaiting_ack); |
- |
-struct NET_EXPORT_PRIVATE QuicRstStreamFrame { |
- QuicRstStreamFrame(); |
- QuicRstStreamFrame(QuicStreamId stream_id, |
- QuicRstStreamErrorCode error_code, |
- QuicStreamOffset bytes_written); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<( |
- std::ostream& os, |
- const QuicRstStreamFrame& r); |
- |
- QuicStreamId stream_id; |
- QuicRstStreamErrorCode error_code; |
- |
- // Used to update flow control windows. On termination of a stream, both |
- // endpoints must inform the peer of the number of bytes they have sent on |
- // that stream. This can be done through normal termination (data packet with |
- // FIN) or through a RST. |
- QuicStreamOffset byte_offset; |
-}; |
- |
-struct NET_EXPORT_PRIVATE QuicConnectionCloseFrame { |
- QuicConnectionCloseFrame(); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<( |
- std::ostream& os, |
- const QuicConnectionCloseFrame& c); |
- |
- QuicErrorCode error_code; |
- std::string error_details; |
-}; |
- |
-struct NET_EXPORT_PRIVATE QuicGoAwayFrame { |
- QuicGoAwayFrame(); |
- QuicGoAwayFrame(QuicErrorCode error_code, |
- QuicStreamId last_good_stream_id, |
- const std::string& reason); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<(std::ostream& os, |
- const QuicGoAwayFrame& g); |
- |
- QuicErrorCode error_code; |
- QuicStreamId last_good_stream_id; |
- std::string reason_phrase; |
-}; |
- |
-// Flow control updates per-stream and at the connection levoel. |
-// Based on SPDY's WINDOW_UPDATE frame, but uses an absolute byte offset rather |
-// than a window delta. |
-// TODO(rjshade): A possible future optimization is to make stream_id and |
-// byte_offset variable length, similar to stream frames. |
-struct NET_EXPORT_PRIVATE QuicWindowUpdateFrame { |
- QuicWindowUpdateFrame() {} |
- QuicWindowUpdateFrame(QuicStreamId stream_id, QuicStreamOffset byte_offset); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<( |
- std::ostream& os, |
- const QuicWindowUpdateFrame& w); |
- |
- // The stream this frame applies to. 0 is a special case meaning the overall |
- // connection rather than a specific stream. |
- QuicStreamId stream_id; |
- |
- // Byte offset in the stream or connection. The receiver of this frame must |
- // not send data which would result in this offset being exceeded. |
- QuicStreamOffset byte_offset; |
-}; |
- |
-// The BLOCKED frame is used to indicate to the remote endpoint that this |
-// endpoint believes itself to be flow-control blocked but otherwise ready to |
-// send data. The BLOCKED frame is purely advisory and optional. |
-// Based on SPDY's BLOCKED frame (undocumented as of 2014-01-28). |
-struct NET_EXPORT_PRIVATE QuicBlockedFrame { |
- QuicBlockedFrame() {} |
- explicit QuicBlockedFrame(QuicStreamId stream_id); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<(std::ostream& os, |
- const QuicBlockedFrame& b); |
- |
- // The stream this frame applies to. 0 is a special case meaning the overall |
- // connection rather than a specific stream. |
- QuicStreamId stream_id; |
-}; |
- |
-// The PATH_CLOSE frame is used to explicitly close a path. Both endpoints can |
-// send a PATH_CLOSE frame to initiate a path termination. A path is considered |
-// to be closed either a PATH_CLOSE frame is sent or received. An endpoint drops |
-// receive side of a closed path, and packets with retransmittable frames on a |
-// closed path are marked as retransmissions which will be transmitted on other |
-// paths. |
-struct NET_EXPORT_PRIVATE QuicPathCloseFrame { |
- QuicPathCloseFrame() {} |
- explicit QuicPathCloseFrame(QuicPathId path_id); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<( |
- std::ostream& os, |
- const QuicPathCloseFrame& p); |
- |
- QuicPathId path_id; |
-}; |
- |
-struct NET_EXPORT_PRIVATE QuicFrame { |
- QuicFrame(); |
- explicit QuicFrame(QuicPaddingFrame padding_frame); |
- explicit QuicFrame(QuicMtuDiscoveryFrame frame); |
- explicit QuicFrame(QuicPingFrame frame); |
- |
- explicit QuicFrame(QuicStreamFrame* stream_frame); |
- explicit QuicFrame(QuicAckFrame* frame); |
- explicit QuicFrame(QuicRstStreamFrame* frame); |
- explicit QuicFrame(QuicConnectionCloseFrame* frame); |
- explicit QuicFrame(QuicStopWaitingFrame* frame); |
- explicit QuicFrame(QuicGoAwayFrame* frame); |
- explicit QuicFrame(QuicWindowUpdateFrame* frame); |
- explicit QuicFrame(QuicBlockedFrame* frame); |
- explicit QuicFrame(QuicPathCloseFrame* frame); |
- |
- NET_EXPORT_PRIVATE friend std::ostream& operator<<(std::ostream& os, |
- const QuicFrame& frame); |
- |
- QuicFrameType type; |
- union { |
- // Frames smaller than a pointer are inline. |
- QuicPaddingFrame padding_frame; |
- QuicMtuDiscoveryFrame mtu_discovery_frame; |
- QuicPingFrame ping_frame; |
- |
- // Frames larger than a pointer. |
- QuicStreamFrame* stream_frame; |
- QuicAckFrame* ack_frame; |
- QuicStopWaitingFrame* stop_waiting_frame; |
- QuicRstStreamFrame* rst_stream_frame; |
- QuicConnectionCloseFrame* connection_close_frame; |
- QuicGoAwayFrame* goaway_frame; |
- QuicWindowUpdateFrame* window_update_frame; |
- QuicBlockedFrame* blocked_frame; |
- QuicPathCloseFrame* path_close_frame; |
- }; |
-}; |
-// QuicFrameType consumes 8 bytes with padding. |
-static_assert(sizeof(QuicFrame) <= 16, |
- "Frames larger than 8 bytes should be referenced by pointer."); |
- |
-typedef std::vector<QuicFrame> QuicFrames; |
- |
-// Deletes all the sub-frames contained in |frames|. |
-NET_EXPORT_PRIVATE void DeleteFrames(QuicFrames* frames); |
- |
-// Deletes all the QuicStreamFrames for the specified |stream_id|. |
-NET_EXPORT_PRIVATE void RemoveFramesForStream(QuicFrames* frames, |
- QuicStreamId stream_id); |
- |
-} // namespace net |
- |
-#endif // NET_QUIC_CORE_QUIC_FRAMES_H_ |