Struct ClientHelloAssembly 

pub struct ClientHelloAssembly { /* private fields */ }

Available on crate features quic and std only.

Reassembles a client’s ClientHello from CRYPTO data taken in fragment by fragment, in any order and with any retransmissions.

Before the header arrives, only received bytes are retained in bounded sparse fragments; a high offset cannot force a large allocation. Once the header arrives, fragments are copied into one buffer sized to the bounded message, and later data is written in place. Every byte seen twice must agree, including retransmissions after the ClientHello is complete: an inspector and the endpoint that later accepts the attempt cannot be shown different names or protocol offers.

The message, and with it the buffer, is bounded by CaptureLimits::client_hello_bytes; the disjoint ranges and pre-header fragments by CaptureLimits::crypto_fragments. Data past the end of the ClientHello is not needed and is ignored.

Implementations

impl ClientHelloAssembly

pub fn new(limits: &CaptureLimits) -> ClientHelloAssembly

pub fn take_in(&mut self, offset: u64, data: &[u8]) -> Result<(), CaptureError>

Take in CRYPTO data at offset.

pub fn client_hello(&self) -> Option<&[u8]>

The complete ClientHello handshake message, once every byte of it arrived.

pub fn received(&self) -> &[u8]

The contiguous start of the ClientHello received so far.

Trait Implementations

impl Debug for ClientHelloAssembly

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.