Struct smoltcp::socket::icmp::Socket

source ·

pub struct Socket<'a> { /* private fields */ }

Expand description

A ICMP socket

An ICMP socket is bound to a specific IcmpEndpoint which may be a specific UDP port to listen for ICMP error messages related to the port or a specific ICMP identifier value. See bind for more details.

Implementations§

source §

impl<'a> Socket<'a>

source

pub fn new( rx_buffer: PacketBuffer<'a>, tx_buffer: PacketBuffer<'a> ) -> Socket<'a>

Create an ICMP socket with the given buffers.

source

pub fn register_recv_waker(&mut self, waker: &Waker)

Register a waker for receive operations.

The waker is woken on state changes that might affect the return value of recv method calls, such as receiving data, or the socket closing.

Notes:

Only one waker can be registered at a time. If another waker was previously registered, it is overwritten and will no longer be woken.
The Waker is woken only once. Once woken, you must register it again to receive more wakes.
“Spurious wakes” are allowed: a wake doesn’t guarantee the result of recv has necessarily changed.

source

pub fn register_send_waker(&mut self, waker: &Waker)

Register a waker for send operations.

The waker is woken on state changes that might affect the return value of send method calls, such as space becoming available in the transmit buffer, or the socket closing.

Notes:

Only one waker can be registered at a time. If another waker was previously registered, it is overwritten and will no longer be woken.
The Waker is woken only once. Once woken, you must register it again to receive more wakes.
“Spurious wakes” are allowed: a wake doesn’t guarantee the result of send has necessarily changed.

source

pub fn hop_limit(&self) -> Option<u8>

Return the time-to-live (IPv4) or hop limit (IPv6) value used in outgoing packets.

pub fn set_hop_limit(&mut self, hop_limit: Option<u8>)

Set the time-to-live (IPv4) or hop limit (IPv6) value used in outgoing packets.

A socket without an explicitly set hop limit value uses the default IANA recommended value (64).

Panics

This function panics if a hop limit value of 0 is given. See RFC 1122 § 3.2.1.7.

source

pub fn bind<T: Into<Endpoint>>(&mut self, endpoint: T) -> Result<(), BindError>

Bind the socket to the given endpoint.

This function returns Err(Error::Illegal) if the socket was open (see is_open), and Err(Error::Unaddressable) if endpoint is unspecified (see is_specified).

Examples

Bind to ICMP Error messages associated with a specific UDP port:

To recv ICMP error messages that are associated with a specific local UDP port, the socket may be bound to a given port using IcmpEndpoint::Udp. This may be useful for applications using UDP attempting to detect and/or diagnose connection problems.

use smoltcp::wire::IpListenEndpoint;
use smoltcp::socket::icmp;

let mut icmp_socket = // ...

// Bind to ICMP error responses for UDP packets sent from port 53.
let endpoint = IpListenEndpoint::from(53);
icmp_socket.bind(icmp::Endpoint::Udp(endpoint)).unwrap();

Bind to a specific ICMP identifier:

To send and recv ICMP packets that are not associated with a specific UDP port, the socket may be bound to a specific ICMP identifier using IcmpEndpoint::Ident. This is useful for sending and receiving Echo Request/Reply messages.

use smoltcp::wire::IpListenEndpoint;
use smoltcp::socket::icmp;

let mut icmp_socket = // ...

// Bind to ICMP messages with the ICMP identifier 0x1234
icmp_socket.bind(icmp::Endpoint::Ident(0x1234)).unwrap();

source

pub fn can_send(&self) -> bool

Check whether the transmit buffer is full.

source

pub fn can_recv(&self) -> bool

Check whether the receive buffer is not empty.

source

pub fn packet_recv_capacity(&self) -> usize

Return the maximum number packets the socket can receive.

source

pub fn packet_send_capacity(&self) -> usize

Return the maximum number packets the socket can transmit.

source

pub fn payload_recv_capacity(&self) -> usize

Return the maximum number of bytes inside the recv buffer.

source

pub fn payload_send_capacity(&self) -> usize

Return the maximum number of bytes inside the transmit buffer.

source

pub fn is_open(&self) -> bool

Check whether the socket is open.

source

pub fn send( &mut self, size: usize, endpoint: IpAddress ) -> Result<&mut [u8], SendError>

Enqueue a packet to be sent to a given remote address, and return a pointer to its payload.

This function returns Err(Error::Exhausted) if the transmit buffer is full, Err(Error::Truncated) if the requested size is larger than the packet buffer size, and Err(Error::Unaddressable) if the remote address is unspecified.

source

pub fn send_with<F>( &mut self, max_size: usize, endpoint: IpAddress, f: F ) -> Result<usize, SendError>
where F: FnOnce(&mut [u8]) -> usize,

Enqueue a packet to be send to a given remote address and pass the buffer to the provided closure. The closure then returns the size of the data written into the buffer.

Also see send.

source

pub fn send_slice( &mut self, data: &[u8], endpoint: IpAddress ) -> Result<(), SendError>

Enqueue a packet to be sent to a given remote address, and fill it from a slice.

pub fn recv(&mut self) -> Result<(&[u8], IpAddress), RecvError>

Dequeue a packet received from a remote endpoint, and return the IpAddress as well as a pointer to the payload.

This function returns Err(Error::Exhausted) if the receive buffer is empty.

source

pub fn recv_slice( &mut self, data: &mut [u8] ) -> Result<(usize, IpAddress), RecvError>

Dequeue a packet received from a remote endpoint, copy the payload into the given slice, and return the amount of octets copied as well as the IpAddress

Note: when the size of the provided buffer is smaller than the size of the payload, the packet is dropped and a RecvError::Truncated error is returned.