Crate cap_net_ext

Extension traits for TcpListener, UdpSocket, and Pool.

cap-std’s TcpListener, following the Rust standard library TcpListener, combines the socket, bind, listen, and connect operations of the POSIX socket API into a single bind or connect operation. In some use cases, it’s desirable to perform the steps separately.

This API adds extension traits to cap-std’s TcpListener, UdpSocket, and Pool which support the following sequence for accepting incoming connections:

• TcpListenerExt::new performs a socket and returns a new TcpListener that is not yet bound.
• Pool::bind_existing_tcp_listener performs a bind, checking that the address is in the Pool.
• TcpListenerExt::listen performs a listen.
• Then, the regular TcpListener::accept may be used to accept new connections. Alternatively, TcpListener::accept_with may be used.

and the following sequence for initiating outgoing connections:

• TcpListenerExt::new performs a socket and returns a new TcpListener that is not yet connected.
• Pool::connect_into_tcp_stream performs a connect, checking that the address is in the Pool.

TcpListenerExt::new and TcpListener::accept_with additionally have Blocking arguments for requesting non-blocking operation.

Similar API adaptations are available for UDP sockets as well.

Structs

TcpBinder

A utility for binding TCP listeners.

TcpConnecter

A utility for making TCP connections.

UdpBinder

A utility for binding UDP sockets.

UdpConnecter

A utility for making UDP connections.

Enums

AddressFamily

Address families supported by TcpListenerExt::new and UdpSocketExt::new.

Blocking

Select blocking or non-blocking mode.

Traits

PoolExt

A trait for extending Pool types.

TcpListenerExt

A trait for extending TcpListener types.

UdpSocketExt

A trait for extending UdpSocket types.