Struct hyper::server::conn::AddrIncoming

#[must_use = "streams do nothing unless polled"]
pub struct AddrIncoming { /* fields omitted */ }

This is supported on crate feature server and (crate features http1 or http2) only.

A stream of connections from binding to an address.

Implementations

impl AddrIncoming

pub fn bind(addr: &SocketAddr) -> Result<Self>

This is supported on crate feature tcp only.

Creates a new AddrIncoming binding to provided socket address.

pub fn from_listener(listener: TcpListener) -> Result<Self>

This is supported on crate feature tcp only.

Creates a new AddrIncoming from an existing tokio::net::TcpListener.

pub fn local_addr(&self) -> SocketAddr

This is supported on crate feature tcp only.

Get the local address bound to this listener.

pub fn set_keepalive(&mut self, keepalive: Option<Duration>) -> &mut Self

This is supported on crate feature tcp only.

Set whether TCP keepalive messages are enabled on accepted connections.

If None is specified, keepalive is disabled, otherwise the duration specified will be the time to remain idle before sending TCP keepalive probes.

pub fn set_nodelay(&mut self, enabled: bool) -> &mut Self

This is supported on crate feature tcp only.

Set the value of TCP_NODELAY option for accepted connections.

pub fn set_sleep_on_errors(&mut self, val: bool)

This is supported on crate feature tcp only.

Set whether to sleep on accept errors.

A possible scenario is that the process has hit the max open files allowed, and so trying to accept a new connection will fail with EMFILE. In some cases, it’s preferable to just wait for some time, if the application will likely close some files (or connections), and try to accept the connection again. If this option is true, the error will be logged at the error level, since it is still a big deal, and then the listener will sleep for 1 second.

In other cases, hitting the max open files should be treat similarly to being out-of-memory, and simply error (and shutdown). Setting this option to false will allow that.

Default is true.

Trait Implementations

impl Accept for AddrIncoming

This is supported on crate feature tcp only.

type Conn = AddrStream

The connection type that can be accepted.

type Error = Error

The error type that can occur when accepting a connection.

fn poll_accept(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Option<Result<Self::Conn, Self::Error>>>

Poll to accept the next connection.

impl Debug for AddrIncoming

This is supported on crate feature tcp only.

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

Formats the value using the given formatter.