Struct SendAncillaryBuffer

pub struct SendAncillaryBuffer<'buf, 'slice, 'fd> { /* private fields */ }

Buffer for sending ancillary messages with sendmsg, sendmsg_v4, sendmsg_v6, sendmsg_unix, and sendmsg_any.

Use the push function to add messages to send.

Implementations

impl<'buf, 'slice, 'fd> SendAncillaryBuffer<'buf, 'slice, 'fd>

pub fn new(buffer: &'buf mut [u8]) -> Self

Create a new, empty SendAncillaryBuffer from a raw byte buffer.

The buffer size may be computed with cmsg_space, or it may be zero for an empty buffer, however in that case, consider default() instead, or even using send instead of sendmsg.

Examples

Allocate a buffer for a single file descriptor:

let mut space = [0; rustix::cmsg_space!(ScmRights(1))];
let mut cmsg_buffer = SendAncillaryBuffer::new(&mut space);

Allocate a buffer for credentials:

let mut space = [0; rustix::cmsg_space!(ScmCredentials(1))];
let mut cmsg_buffer = SendAncillaryBuffer::new(&mut space);

Allocate a buffer for two file descriptors and credentials:

let mut space = [0; rustix::cmsg_space!(ScmRights(2), ScmCredentials(1))];
let mut cmsg_buffer = SendAncillaryBuffer::new(&mut space);

pub fn clear(&mut self)

Delete all messages from the buffer.

pub fn push(&mut self, msg: SendAncillaryMessage<'slice, 'fd>) -> bool

Add an ancillary message to the buffer.

Returns true if the message was added successfully.

Trait Implementations

impl Default for SendAncillaryBuffer<'_, '_, '_>

fn default() -> Self

Returns the “default value” for a type.

impl<'slice, 'fd> Extend<SendAncillaryMessage<'slice, 'fd>> for SendAncillaryBuffer<'_, 'slice, 'fd>

fn extend<T: IntoIterator<Item = SendAncillaryMessage<'slice, 'fd>>>( &mut self, iter: T, )

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl<'buf> From<&'buf mut [u8]> for SendAncillaryBuffer<'buf, '_, '_>

fn from(buffer: &'buf mut [u8]) -> Self

Converts to this type from the input type.