Struct UdpScionSocket 

pub struct UdpScionSocket<P: PathManager = MultiPathManager> { /* private fields */ }

A path aware UDP socket generic over the underlay socket and path manager.

Implementations

impl<P: PathManager> UdpScionSocket<P>

pub fn new( socket: PathUnawareUdpScionSocket, pather: Arc<P>, connect_timeout: Duration, send_error_receivers: Subscribers<dyn SendErrorReceiver>, ) -> Self

Creates a new path aware UDP SCION socket.

pub async fn connect( self, remote_addr: SocketAddr, ) -> Result<Self, ScionSocketConnectError>

Connects the socket to a remote address.

Ensures a Path to the Destination exists, returns an error if not.

Timeouts after configured connect_timeout

pub async fn send(&self, payload: &[u8]) -> Result<(), ScionSocketSendError>

Send a datagram to the connected remote address.

pub async fn send_to( &self, payload: &[u8], destination: SocketAddr, ) -> Result<(), ScionSocketSendError>

Send a datagram to the specified destination.

pub async fn send_to_via( &self, payload: &[u8], destination: SocketAddr, path: &Path<&[u8]>, ) -> Result<(), ScionSocketSendError>

Send a datagram to the specified destination via the specified path.

pub async fn recv_from_with_path<'a>( &'a self, buffer: &'a mut [u8], path_buffer: &'a mut [u8], ) -> Result<(usize, SocketAddr, Path<&'a mut [u8]>), ScionSocketReceiveError>

Receive a datagram from any address, along with the sender address and path.

pub async fn recv_from( &self, buffer: &mut [u8], ) -> Result<(usize, SocketAddr), ScionSocketReceiveError>

Receive a datagram from the connected remote address and write it into the provided buffer.

pub async fn recv( &self, buffer: &mut [u8], ) -> Result<usize, ScionSocketReceiveError>

Receive a datagram from the connected remote address.

Datagrams from other addresses are silently discarded.

pub fn local_addr(&self) -> SocketAddr

Returns the local socket address.

Trait Implementations

impl<P: PathManager> Debug for UdpScionSocket<P>

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

Formats the value using the given formatter.