Struct HeaderReadTimeout 

pub struct HeaderReadTimeout {
    pub grace: Duration,
    pub min_rate: u32,
    pub ceiling: Duration,
}

Available on crate features http-backend and http and std only.

Deadline for receiving a complete request head, measured from its first byte.

A head is never cut within grace. After that it is cut as soon as the average rate at which its bytes arrived, counted from its first byte, falls below min_rate, so a slow but progressing client keeps going while a trickle is cut. A head still incomplete at ceiling is cut whatever its rate.

HTTP/1 closes the connection; HTTP/2 sends GOAWAY with ENHANCE_YOUR_CALM and closes it, as an open header block stalls the whole connection; HTTP/3 resets only that request stream with H3_REQUEST_REJECTED, which tells the client it may retry, unless the connection never received a complete head, in which case it also closes the connection gracefully.

Fields

grace: Duration

Never cut a head within this window after its first byte.

Extended by four round trips, at most doubled, when the connection measured its round-trip time.

min_rate: u32

After the grace window, cut a head whose average arrival rate is below this many bytes per second. Zero disables the rate rule.

ceiling: Duration

Cut a head still incomplete after this long, whatever its rate.

Implementations

impl HeaderReadTimeout

pub const DEFAULT: HeaderReadTimeout

10 s of grace, a floor of 256 bytes per second, and a 60 s ceiling.

Ten seconds absorbs a few lost-segment retransmissions. 256 B/s lets a 2.5 KiB head through within the grace window and is far above what a trickling attacker sends, yet far below any working link. Established servers cap header reads at 60 s.

Trait Implementations

impl Clone for HeaderReadTimeout

fn clone(&self) -> HeaderReadTimeout

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for HeaderReadTimeout

impl Debug for HeaderReadTimeout

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

Formats the value using the given formatter.

impl Default for HeaderReadTimeout

fn default() -> HeaderReadTimeout

Returns the “default value” for a type.

impl Eq for HeaderReadTimeout

impl PartialEq for HeaderReadTimeout

fn eq(&self, other: &HeaderReadTimeout) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HeaderReadTimeout