Struct RawSocket 

pub struct RawSocket { /* private fields */ }

A raw IP socket used for ICMP and ICMPv6 traffic.

Implementations

impl RawSocket

pub fn new(ip_version: IpVersion, ip_protocol: IpProtocol) -> Self

Creates a raw socket for the given IP version and protocol.

pub fn new_ipv4_ping() -> Self

Creates an IPv4 ICMP ping socket with Linux SOCK_DGRAM semantics.

pub fn bind_device(&self, interface_id: InterfaceId) -> NetResult

Restricts this socket to one interface for route selection.

Trait Implementations

impl Configurable for RawSocket

fn get_option_inner(&self, option: &mut GetSocketOption<'_>) -> NetResult<bool>

Get a socket option, returns true if the socket supports the option.

fn set_option_inner(&self, option: SetSocketOption<'_>) -> NetResult<bool>

Set a socket option, returns true if the socket supports the option.

fn get_option(&self, opt: GetSocketOption<'_>) -> NetResult

Get a socket option. Dispatches to Configurable::get_option_inner.

fn set_option(&self, opt: SetSocketOption<'_>) -> NetResult

Set a socket option. Dispatches to Configurable::set_option_inner.

impl Drop for RawSocket

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl From<Box<RawSocket>> for Socket

fn from(v: Box<RawSocket>) -> Socket

Converts to this type from the input type.

impl Pollable for RawSocket

fn poll(&self) -> IoEvents

Polls for I/O events.

unsafe fn register_shared( &self, sink: &mut dyn SharedRegistrationSink, events: IoEvents, )

Registers a shared readiness observer.

unsafe fn register_exclusive( &self, sink: &mut dyn ExclusiveRegistrationSink, events: IoEvents, )

Registers a consumer that may sleep until readiness changes.

impl SocketOps for RawSocket

fn bind(&self, local_addr: SocketAddrEx) -> NetResult

Binds an unbound socket to the given address and port.

fn start_connect(&self, remote_addr: SocketAddrEx) -> NetResult<ConnectStatus>

Starts a connection without waiting for asynchronous completion.

fn try_send( &self, src: impl Read + IoBuf, options: &mut SendOptions, ) -> NetResult<usize>

Attempts to send data without parking the caller.

fn try_recv( &self, dst: impl Write + IoBufMut, options: &mut RecvOptions<'_>, ) -> NetResult<usize>

Attempts to receive data without parking the caller.

fn local_addr(&self) -> NetResult<SocketAddrEx>

Get the local endpoint of the socket.

fn peer_addr(&self) -> NetResult<SocketAddrEx>

Get the remote endpoint of the socket.

fn shutdown(&self, how: Shutdown) -> NetResult

Shutdown the socket, closing the connection.

fn connect_status(&self) -> NetResult<ConnectStatus>

Checks a previously started asynchronous connection.

fn listen(&self, _backlog: usize) -> NetResult

Starts listening on the bound address and port.

fn is_listening(&self) -> bool

Returns whether this socket currently accepts incoming connections.

fn try_accept(&self) -> NetResult<Socket>

Attempts to accept one connection without parking the caller.

fn recv_available(&self) -> NetResult<usize>

Returns the number of bytes that can be read without blocking.

fn send_wait_policy( &self, extra_nonblocking: bool, ) -> NetResult<SocketWaitPolicy>

Returns the send wait policy without acquiring scheduler ownership.

fn recv_wait_policy( &self, extra_nonblocking: bool, ) -> NetResult<SocketWaitPolicy>

Returns the receive wait policy without acquiring scheduler ownership.

impl TryInto<Box<RawSocket>> for Socket

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into( self, ) -> Result<Box<RawSocket>, <Self as TryInto<Box<RawSocket>>>::Error>

Performs the conversion.