Struct socket2::SockAddr

pub struct SockAddr { /* fields omitted */ }

The address of a socket.

SockAddrs may be constructed directly to and from the standard library SocketAddr, SocketAddrV4, and SocketAddrV6 types.

Implementations

impl SockAddr

pub unsafe fn init<F, T>(init: F) -> Result<(T, SockAddr)> where
    F: FnOnce(*mut sockaddr_storage, *mut socklen_t) -> Result<T>, 

Initialise a SockAddr by calling the function init.

The type of the address storage and length passed to the function init is OS/architecture specific.

Safety

Caller must initialise the provided address storage and set the length properly. The address is zeroed before init is called and is thus valid to dereference and read from. The length initialised to the maximum length of the storage.

Examples

use std::io;
use std::os::unix::io::AsRawFd;

use socket2::{SockAddr, Socket, Domain, Type};

let socket = Socket::new(Domain::IPV4, Type::STREAM, None)?;

// Initialise a `SocketAddr` byte calling `getsockname(2)`.
let (_, address) = unsafe {
    SockAddr::init(|addr_storage, len| {
        // The `getsockname(2)` system call will intiliase `storage` for
        // us, setting `len` to the correct length.
        if libc::getsockname(socket.as_raw_fd(), addr_storage.cast(), len) == -1 {
            Err(io::Error::last_os_error())
        } else {
            Ok(())
        }
    })
}?;

pub const fn family(&self) -> sa_family_t

Returns this address's family.

pub const fn len(&self) -> socklen_t

Returns the size of this address in bytes.

pub const fn as_ptr(&self) -> *const sockaddr

Returns a raw pointer to the address.

pub fn as_socket(&self) -> Option<SocketAddr>

Returns this address as a SocketAddr if it is in the AF_INET (IPv4) or AF_INET6 (IPv6) family, otherwise returns None.

pub fn as_socket_ipv4(&self) -> Option<SocketAddrV4>

Returns this address as a SocketAddrV4 if it is in the AF_INET family.

pub fn as_socket_ipv6(&self) -> Option<SocketAddrV6>

Returns this address as a SocketAddrV6 if it is in the AF_INET6 family.

impl SockAddr

Unix only API.

pub fn unix<P>(path: P) -> Result<SockAddr> where
    P: AsRef<Path>, 

Constructs a SockAddr with the family AF_UNIX and the provided path.

This function is only available on Unix.

Failure

Returns an error if the path is longer than SUN_LEN.

impl SockAddr

pub fn vsock(cid: u32, port: u32) -> Result<SockAddr>

Constructs a SockAddr with the family AF_VSOCK and the provided CID/port.

This function is only available on Linux.

pub fn vsock_address(&self) -> Option<(u32, u32)>

Returns this address VSOCK CID/port if it is in the AF_VSOCK family, otherwise return None.

Trait Implementations

impl Debug for SockAddr

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

Formats the value using the given formatter.

impl From<SocketAddr> for SockAddr

fn from(addr: SocketAddr) -> SockAddr

Performs the conversion.

impl From<SocketAddrV4> for SockAddr

fn from(addr: SocketAddrV4) -> SockAddr

Performs the conversion.

impl From<SocketAddrV6> for SockAddr

fn from(addr: SocketAddrV6) -> SockAddr

Performs the conversion.