OLD | NEW |
(Empty) | |
| 1 // Copyright 2016 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 #ifndef NET_HTTP2_DECODER_DECODE_HTTP2_STRUCTURES_H_ |
| 6 #define NET_HTTP2_DECODER_DECODE_HTTP2_STRUCTURES_H_ |
| 7 |
| 8 // Provides functions for decoding the fixed size structures in the HTTP/2 spec. |
| 9 |
| 10 // TODO(jamessynge): Consider whether the value of the SlowDecode methods is |
| 11 // worth their complexity; in particular, dropping back to buffering at most |
| 12 // 9 bytes (the largest fixed size structure) may actually be more efficient |
| 13 // than using the SlowDecode methods, or at least worth the complexity |
| 14 // reduction. |
| 15 // See http2_structure_decoder.h et al for an experiment in removing all except |
| 16 // DoDecode. |
| 17 |
| 18 #include "net/base/net_export.h" |
| 19 #include "net/http2/decoder/decode_buffer.h" |
| 20 #include "net/http2/http2_structures.h" |
| 21 |
| 22 namespace net { |
| 23 |
| 24 // DoDecode(STRUCTURE* out, DecodeBuffer* b) decodes the structure from start |
| 25 // to end, advancing the cursor by STRUCTURE::EncodedSize(). The decoder buffer |
| 26 // must be large enough (i.e. b->Remaining() >= STRUCTURE::EncodedSize()). |
| 27 |
| 28 NET_EXPORT_PRIVATE void DoDecode(Http2FrameHeader* out, DecodeBuffer* b); |
| 29 NET_EXPORT_PRIVATE void DoDecode(Http2PriorityFields* out, DecodeBuffer* b); |
| 30 NET_EXPORT_PRIVATE void DoDecode(Http2RstStreamFields* out, DecodeBuffer* b); |
| 31 NET_EXPORT_PRIVATE void DoDecode(Http2SettingFields* out, DecodeBuffer* b); |
| 32 NET_EXPORT_PRIVATE void DoDecode(Http2PushPromiseFields* out, DecodeBuffer* b); |
| 33 NET_EXPORT_PRIVATE void DoDecode(Http2PingFields* out, DecodeBuffer* b); |
| 34 NET_EXPORT_PRIVATE void DoDecode(Http2GoAwayFields* out, DecodeBuffer* b); |
| 35 NET_EXPORT_PRIVATE void DoDecode(Http2WindowUpdateFields* out, DecodeBuffer* b); |
| 36 NET_EXPORT_PRIVATE void DoDecode(Http2AltSvcFields* out, DecodeBuffer* b); |
| 37 |
| 38 // MaybeDecode(STRUCTURE* out, DecodeBuffer* b) decodes the structure from |
| 39 // start to end if the decoder buffer is large enough, advancing the cursor |
| 40 // by STRUCTURE::EncodedSize(), then returns true. |
| 41 // If the decode buffer isn't large enough, does nothing and returns false. |
| 42 // The buffer is large enough if b->Remaining() >= STRUCTURE::EncodedSize(). |
| 43 |
| 44 NET_EXPORT_PRIVATE bool MaybeDecode(Http2FrameHeader* out, DecodeBuffer* b); |
| 45 NET_EXPORT_PRIVATE bool MaybeDecode(Http2PriorityFields* out, DecodeBuffer* b); |
| 46 NET_EXPORT_PRIVATE bool MaybeDecode(Http2RstStreamFields* out, DecodeBuffer* b); |
| 47 NET_EXPORT_PRIVATE bool MaybeDecode(Http2SettingFields* out, DecodeBuffer* b); |
| 48 NET_EXPORT_PRIVATE bool MaybeDecode(Http2PushPromiseFields* out, |
| 49 DecodeBuffer* b); |
| 50 NET_EXPORT_PRIVATE bool MaybeDecode(Http2PingFields* out, DecodeBuffer* b); |
| 51 NET_EXPORT_PRIVATE bool MaybeDecode(Http2GoAwayFields* out, DecodeBuffer* b); |
| 52 NET_EXPORT_PRIVATE bool MaybeDecode(Http2WindowUpdateFields* out, |
| 53 DecodeBuffer* b); |
| 54 NET_EXPORT_PRIVATE bool MaybeDecode(Http2AltSvcFields* out, DecodeBuffer* b); |
| 55 |
| 56 // SlowDecode(STRUCTURE* out, DecodeBuffer* b, uint32_t* offset) provides |
| 57 // incremental decoding of a structure, supporting cases where the structure |
| 58 // is split across multiple input buffers. *offset represents the offset within |
| 59 // the encoding of the structure, in the range [0, STRUCTURE::EncodedSize()]. |
| 60 // Returns true when it is able to completely decode the structure, false |
| 61 // before that. Updates *offset to record the progress decoding the structure; |
| 62 // if false is returned, then b->Remaining() == 0 when SlowDecode returns. |
| 63 |
| 64 NET_EXPORT_PRIVATE bool SlowDecode(Http2FrameHeader* out, |
| 65 DecodeBuffer* b, |
| 66 uint32_t* offset); |
| 67 NET_EXPORT_PRIVATE bool SlowDecode(Http2PriorityFields* out, |
| 68 DecodeBuffer* b, |
| 69 uint32_t* offset); |
| 70 NET_EXPORT_PRIVATE bool SlowDecode(Http2RstStreamFields* out, |
| 71 DecodeBuffer* b, |
| 72 uint32_t* offset); |
| 73 NET_EXPORT_PRIVATE bool SlowDecode(Http2SettingFields* out, |
| 74 DecodeBuffer* b, |
| 75 uint32_t* offset); |
| 76 NET_EXPORT_PRIVATE bool SlowDecode(Http2PushPromiseFields* out, |
| 77 DecodeBuffer* b, |
| 78 uint32_t* offset); |
| 79 NET_EXPORT_PRIVATE bool SlowDecode(Http2PingFields* out, |
| 80 DecodeBuffer* b, |
| 81 uint32_t* offset); |
| 82 NET_EXPORT_PRIVATE bool SlowDecode(Http2GoAwayFields* out, |
| 83 DecodeBuffer* b, |
| 84 uint32_t* offset); |
| 85 NET_EXPORT_PRIVATE bool SlowDecode(Http2WindowUpdateFields* out, |
| 86 DecodeBuffer* b, |
| 87 uint32_t* offset); |
| 88 NET_EXPORT_PRIVATE bool SlowDecode(Http2AltSvcFields* out, |
| 89 DecodeBuffer* b, |
| 90 uint32_t* offset); |
| 91 |
| 92 } // namespace net |
| 93 |
| 94 #endif // NET_HTTP2_DECODER_DECODE_HTTP2_STRUCTURES_H_ |
OLD | NEW |