Struct cap_std::net::Pool

pub struct Pool { /* private fields */ }

Available on non-WASI only.

A pool of network addresses.

This does not directly correspond to anything in std, however its methods correspond to the several functions in std::net.

Implementations

impl Pool

pub fn new() -> Self

Construct a new empty pool.

pub fn insert_ip_net(
    &mut self,
    ip_net: IpNet,
    port: u16,
    ambient_authority: AmbientAuthority
)

Add a range of network addresses with a specific port to the pool.

AmbientAuthority

This function allows ambient access to any IP address.

pub fn insert_socket_addr(
    &mut self,
    addr: SocketAddr,
    ambient_authority: AmbientAuthority
)

Add a specific net::SocketAddr to the pool.

AmbientAuthority

This function allows ambient access to any IP address.

pub fn bind_tcp_listener<A: ToSocketAddrs>(
    &self,
    addr: A
) -> Result<TcpListener>

Creates a new TcpListener which will be bound to the specified address.

This corresponds to std::net::TcpListener::bind.

pub fn connect_tcp_stream<A: ToSocketAddrs>(&self, addr: A) -> Result<TcpStream>

Opens a TCP connection to a remote host.

This corresponds to std::net::TcpStream::connect.

pub fn connect_timeout_tcp_stream(
    &self,
    addr: &SocketAddr,
    timeout: Duration
) -> Result<TcpStream>

Opens a TCP connection to a remote host with a timeout.

This corresponds to std::net::TcpStream::connect_timeout.

pub fn bind_udp_socket<A: ToSocketAddrs>(&self, addr: A) -> Result<UdpSocket>

Creates a UDP socket from the given address.

This corresponds to std::net::UdpSocket::bind.

pub fn send_to_udp_socket_addr<A: ToSocketAddrs>(
    &self,
    udp_socket: &UdpSocket,
    buf: &[u8],
    addr: A
) -> Result<usize>

Sends data on the socket to the given address. On success, returns the number of bytes written.

This corresponds to std::net::UdpSocket::send_to.

pub fn connect_udp_socket<A: ToSocketAddrs>(
    &self,
    udp_socket: &UdpSocket,
    addr: A
) -> Result<()>

Connects this UDP socket to a remote address, allowing the send and recv syscalls to be used to send data and also applies filters to only receive data from the specified address.

This corresponds to std::net::UdpSocket::connect.

Trait Implementations

impl Clone for Pool

fn clone(&self) -> Pool

Returns a copy of the value.

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

Performs copy-assignment from source.