Struct roa_tcp::TcpIncoming

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

A stream of connections from binding to an address. As an implementation of roa_core::Accept.

Methods

impl TcpIncoming

pub fn bind(addr: impl ToSocketAddrs) -> Result<Self>

Creates a new TcpIncoming binding to provided socket address.

pub fn from_std(listener: StdListener) -> Result<Self>

Creates a new TcpIncoming from std TcpListener.

pub fn local_addr(&self) -> SocketAddr

Get the local address bound to this listener.

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

Set the value of TCP_NODELAY option for accepted connections.

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

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.

pub fn poll_stream(&mut self, cx: &mut Context) -> Poll<Result<TcpStream>>

Poll TcpStream.

Trait Implementations

impl Accept for TcpIncoming

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 TcpIncoming

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

Formats the value using the given formatter.