Struct ConnCtrl 

pub struct ConnCtrl { /* private fields */ }

Controls the lifetime of the transport connection serving a request.

A control is shared by every request multiplexed over the same connection. Shutting down an HTTP/2 or HTTP/3 connection therefore also affects its other in-flight request streams.

Implementations

impl ConnCtrl

pub fn new() -> Self

Creates a connection control in the running state.

pub fn graceful_shutdown(&self)

Stops accepting new requests and lets accepted requests finish.

A later call to abort escalates graceful shutdown to an immediate abort.

pub fn abort(&self)

Immediately aborts the underlying transport connection.

The server will abruptly close the connection without sending any response. This causes clients to encounter errors such as curl: (52) Empty reply from server.

Aborting the connection immediately frees up system resources allocated to the request flow. This forceful teardown should only be used in critical scenarios, such as mitigating active attacks, where maintaining the connection poses a security risk.

pub fn is_graceful_shutdown(&self) -> bool

Returns true after graceful shutdown has been requested.

pub fn is_aborted(&self) -> bool

Returns true after immediate abort has been requested.

pub fn relax_timeouts(&self)

Suspends the transport idle and write-stall fuse timeouts for this connection.

The fuse connection_idle_timeout and write_stall_timeout exist to close connections that stall mid-request. Long-lived protocols built on top of an HTTP upgrade — WebSocket, or a hand-rolled tunnel — legitimately spend long stretches with no transport activity and would otherwise trip those timers. A handler that hands the connection off to such a protocol should call this to keep the transport open.

This does not affect graceful_shutdown or abort; an aborted connection is still torn down.

pub fn is_relaxed(&self) -> bool

Returns true once relax_timeouts has been called.

Trait Implementations

impl Clone for ConnCtrl

fn clone(&self) -> ConnCtrl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnCtrl

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

Formats the value using the given formatter.

impl Default for ConnCtrl

fn default() -> Self

Returns the “default value” for a type.