Enum nix::sys::socket::ControlMessage

pub enum ControlMessage<'a> {
    ScmRights(&'a [RawFd]),
    ScmCreds,
    Ipv6PacketInfo(&'a in6_pktinfo),
}

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

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.

ScmCreds

A message of type SCM_CREDS, containing the pid, uid, euid, gid and groups of a process connected to the socket.

This is similar to the socket options LOCAL_CREDS and LOCAL_PEERCRED, but requires a process to explicitly send its credentials.

Credentials are always overwritten by the kernel, so this variant does have any data, unlike the receive-side [ControlMessageOwned::ScmCreds][#enum.ControlMessageOwned.html#variant.ScmCreds].

For further information, please refer to the unix(4) man page.

Ipv6PacketInfo(&'a in6_pktinfo)

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>