Enum nix::sys::socket::ControlMessage

#[non_exhaustive]
pub enum ControlMessage<'a> {
    ScmRights(&'a [RawFd]),
    Ipv4PacketInfo(&'a in_pktinfo),
    Ipv6PacketInfo(&'a in6_pktinfo),
}

Available on crate features socket and uio only.

A type-safe zero-copy wrapper around a single control message, as used wih sendmsg. More types may be added to this enum; do not exhaustively pattern-match it.

Further reading

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ScmRights(&'a [RawFd])

A message of type SCM_RIGHTS, containing an array of file descriptors passed between processes.

See the description in the “Ancillary messages” section of the unix(7) man page.

Using multiple ScmRights messages for a single sendmsg call isn’t recommended since it causes platform-dependent behaviour: It might swallow all but the first ScmRights message or fail with EINVAL. Instead, you can put all fds to be passed into a single ScmRights message.

Ipv4PacketInfo(&'a in_pktinfo)

Available on crate feature net only.

Configure the sending addressing and interface for v4

For further information, please refer to the ip(7) man page.

Ipv6PacketInfo(&'a in6_pktinfo)

Available on crate feature net only.

Configure the sending addressing and interface for v6

For further information, please refer to the ipv6(7) man page.

Trait Implementations

impl<'a> Clone for ControlMessage<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ControlMessage<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<ControlMessage<'a>> for ControlMessage<'a>

fn eq(&self, other: &ControlMessage<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ControlMessage<'a>) -> bool

This method tests for !=.

impl<'a> Copy for ControlMessage<'a>

impl<'a> Eq for ControlMessage<'a>

impl<'a> StructuralEq for ControlMessage<'a>

impl<'a> StructuralPartialEq for ControlMessage<'a>