7f21954724
* comments * wip * wip * Sketch out pingpong and keepalive stack modules PingPong responds to ping requests with acknowledgements. KeepAlive issues ping requests on idle connections. * remove keepalive for now * commentary * prettify ping_pong's poll * test ping pong and passthrough * add buffering test * Use a fixed-size slice for ping payloads * Improve pong dispatch pong messages should be buffered until Stream::poll returns Async::NotReady or Async::Ready(None) (i.e. such that it is not expected to be polled again). pong messages are now dispatched when no more data may be polled or the Sink half is activated. * revert name change * touchup * wip * Simplify Stream::poll Now PingPong only holds at most one pending pong and the stream will not produce additional frames unti the ping has been sent. Furthermore, we shouldn't have to call inner.poll_complete quite so frequently. * avoid Bytes::split_to * only use buf internally to Ping::load
124 lines
3.2 KiB
Rust
124 lines
3.2 KiB
Rust
use hpack;
|
|
use error::{ConnectionError, Reason};
|
|
|
|
/// A helper macro that unpacks a sequence of 4 bytes found in the buffer with
|
|
/// the given identifier, starting at the given offset, into the given integer
|
|
/// type. Obviously, the integer type should be able to support at least 4
|
|
/// bytes.
|
|
///
|
|
/// # Examples
|
|
///
|
|
/// ```rust
|
|
/// let buf: [u8; 4] = [0, 0, 0, 1];
|
|
/// assert_eq!(1u32, unpack_octets_4!(buf, 0, u32));
|
|
/// ```
|
|
#[macro_escape]
|
|
macro_rules! unpack_octets_4 {
|
|
// TODO: Get rid of this macro
|
|
($buf:expr, $offset:expr, $tip:ty) => (
|
|
(($buf[$offset + 0] as $tip) << 24) |
|
|
(($buf[$offset + 1] as $tip) << 16) |
|
|
(($buf[$offset + 2] as $tip) << 8) |
|
|
(($buf[$offset + 3] as $tip) << 0)
|
|
);
|
|
}
|
|
|
|
mod data;
|
|
mod go_away;
|
|
mod head;
|
|
mod headers;
|
|
mod ping;
|
|
mod reset;
|
|
mod settings;
|
|
mod util;
|
|
|
|
pub use self::data::Data;
|
|
pub use self::go_away::GoAway;
|
|
pub use self::head::{Head, Kind, StreamId};
|
|
pub use self::headers::{Headers, PushPromise, Continuation, Pseudo};
|
|
pub use self::ping::Ping;
|
|
pub use self::reset::Reset;
|
|
pub use self::settings::{Settings, SettingSet};
|
|
|
|
// Re-export some constants
|
|
pub use self::settings::{
|
|
DEFAULT_SETTINGS_HEADER_TABLE_SIZE,
|
|
DEFAULT_MAX_FRAME_SIZE,
|
|
};
|
|
|
|
pub const HEADER_LEN: usize = 9;
|
|
|
|
#[derive(Debug /*, Clone, PartialEq */)]
|
|
pub enum Frame {
|
|
Data(Data),
|
|
Headers(Headers),
|
|
PushPromise(PushPromise),
|
|
Settings(Settings),
|
|
Ping(Ping)
|
|
}
|
|
|
|
/// Errors that can occur during parsing an HTTP/2 frame.
|
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
|
pub enum Error {
|
|
/// A full frame header was not passed.
|
|
Short,
|
|
|
|
/// An unsupported value was set for the flag value.
|
|
BadFlag,
|
|
|
|
/// An unsupported value was set for the frame kind.
|
|
BadKind,
|
|
|
|
/// A length value other than 8 was set on a PING message.
|
|
BadFrameSize,
|
|
|
|
/// The padding length was larger than the frame-header-specified
|
|
/// length of the payload.
|
|
TooMuchPadding,
|
|
|
|
/// The payload length specified by the frame header was shorter than
|
|
/// necessary for the parser settings specified and the frame type.
|
|
///
|
|
/// This happens if, for instance, the priority flag is set and the
|
|
/// header length is shorter than a stream dependency.
|
|
///
|
|
/// `PayloadLengthTooShort` should be treated as a protocol error.
|
|
PayloadLengthTooShort,
|
|
|
|
/// The payload length specified by the frame header of a settings frame
|
|
/// was not a round multiple of the size of a single setting.
|
|
PartialSettingLength,
|
|
|
|
/// The payload length specified by the frame header was not the
|
|
/// value necessary for the specific frame type.
|
|
InvalidPayloadLength,
|
|
|
|
/// Received a payload with an ACK settings frame
|
|
InvalidPayloadAckSettings,
|
|
|
|
/// An invalid stream identifier was provided.
|
|
///
|
|
/// This is returned if a SETTINGS or PING frame is received with a stream
|
|
/// identifier other than zero.
|
|
InvalidStreamId,
|
|
|
|
/// Failed to perform HPACK decoding
|
|
Hpack(hpack::DecoderError),
|
|
}
|
|
|
|
// ===== impl Frame ======
|
|
|
|
impl Frame {
|
|
}
|
|
|
|
// ===== impl Error =====
|
|
|
|
impl From<Error> for ConnectionError {
|
|
fn from(src: Error) -> ConnectionError {
|
|
match src {
|
|
// TODO: implement
|
|
_ => ConnectionError::Proto(Reason::ProtocolError),
|
|
}
|
|
}
|
|
}
|