Module linux_io::fd::sockopt

A safer abstraction for setsockopt and getsockopt.

These system calls are very open-ended, supporting a variety of different operations with different argument and result types. Passing the wrong kind of value to the wrong command can cause memory corruption.

To make these a little safer to use, this module provides option constants that also include information about the argument and result types, so that the super::File::setsockopt and super::File::getsockopt methods can then provide a type-safe interface as long as these constants are defined correctly.

This module defines constants for the main sockets API options. Protocol-specific options might also be available in other modules, or potentially in other crates.

Structs

DirectSockOpt

Implementation of both SetSockOpt and GetSockOpt with fixed level and optname values, passing the arg type directly through to the underlying system calls.

DirectSockOptReadOnly

Implementation of just GetSockOpt with fixed level and optname values, similar to DirectSockOpt but for read-only options.

Constants

SOL_SOCKET

The sockopt “level” for general socket options that are not protocol-specific.

SO_ACCEPTCONN

Indicates whether or not this socket has been marked to accept connections e.g. using super::File::listen.

SO_DOMAIN

Returns the protocol/address family for this socket.

SO_DONTROUTE

Send only to directly-connected hosts, ignoring any configured gateway.

SO_KEEPALIVE

Send period keepalive messages on connection-oriented sockets.

Traits

GetSockOpt

Implemented by options that can be used with getsockopt.

SetSockOpt

Implemented by options that can be used with setsockopt.

Functions

sockopt^⚠

Constructs a new “simple” socket option whose safe-facing argument type is the same as its internal type and whose level and option name are fixed.

sockopt_readonly^⚠

Constructs a new “simple” socket option that is read-only.