Struct SendItem 

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

A single outbound UDP datagram.

Build with SendItem::new and optionally chain ecn / segment_size to attach ancillary data.

When segment_size is set and the platform supports it (Linux GSO), the kernel will segment data into multiple datagrams of segment_size bytes each (the final segment may be shorter). This allows sending N packets in a single syscall.

Implementations

impl<'a> SendItem<'a>

pub fn new(destination: SocketAddr, data: &'a [u8]) -> Self

Create a datagram targeting destination with the given data payload. Address comes first, then data.

pub fn ecn(self, ecn: Ecn) -> Self

Attach an ECN codepoint to the outgoing datagram.

pub fn segment_size(self, segment_size: u16) -> Self

Enable UDP segmentation offload (GSO on Linux). The kernel will split data into consecutive chunks of segment_size bytes and send each as a separate UDP datagram to the same destination.

data.len() must be a multiple of segment_size, except for the final segment which may be shorter.

Trait Implementations

impl<'a> Clone for SendItem<'a>

fn clone(&self) -> SendItem<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for SendItem<'a>