Enum nix::sys::socket::ControlMessage[][src]

pub enum ControlMessage<'a> {
    ScmRights(&'a [RawFd]),
    ScmCredentials(&'a UnixCredentials),
    AlgSetIv(&'a [u8]),
    AlgSetOp(&'a c_int),
    AlgSetAeadAssoclen(&'a u32),
    UdpGsoSegments(&'a u16),
    Ipv4PacketInfo(&'a in_pktinfo),
    Ipv6PacketInfo(&'a in6_pktinfo),
    RxqOvfl(&'a u32),
}
Expand description

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 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.

Tuple Fields of ScmRights

0: &'a [RawFd]
ScmCredentials

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

This is similar to the socket option SO_PEERCRED, but requires a process to explicitly send its credentials. A process running as root is allowed to specify any credentials, while credentials sent by other processes are verified by the kernel.

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

Tuple Fields of ScmCredentials

0: &'a UnixCredentials
AlgSetIv

Set IV for AF_ALG crypto API.

For further information, please refer to the documentation

Tuple Fields of AlgSetIv

0: &'a [u8]
AlgSetOp

Set crypto operation for AF_ALG crypto API. It may be one of ALG_OP_ENCRYPT or ALG_OP_DECRYPT

For further information, please refer to the documentation

Tuple Fields of AlgSetOp

0: &'a c_int
AlgSetAeadAssoclen

Set the length of associated authentication data (AAD) (applicable only to AEAD algorithms) for AF_ALG crypto API.

For further information, please refer to the documentation

Tuple Fields of AlgSetAeadAssoclen

0: &'a u32
UdpGsoSegments

UDP GSO makes it possible for applications to generate network packets for a virtual MTU much greater than the real one. The length of the send data no longer matches the expected length on the wire. The size of the datagram payload as it should appear on the wire may be passed through this control message. Send buffer should consist of multiple fixed-size wire payloads following one by one, and the last, possibly smaller one.

Tuple Fields of UdpGsoSegments

0: &'a u16
Ipv4PacketInfo

Configure the sending addressing and interface for v4

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

Tuple Fields of Ipv4PacketInfo

0: &'a in_pktinfo
Ipv6PacketInfo

Configure the sending addressing and interface for v6

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

Tuple Fields of Ipv6PacketInfo

0: &'a in6_pktinfo
RxqOvfl

SO_RXQ_OVFL indicates that an unsigned 32 bit value ancilliary msg (cmsg) should be attached to recieved skbs indicating the number of packets dropped by the socket between the last recieved packet and this received packet.

Tuple Fields of RxqOvfl

0: &'a u32

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

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

This method tests for !=.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Performs the conversion.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

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

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.