pub struct SockAddr { /* private fields */ }
Expand description
The address of a socket.
SockAddr
s may be constructed directly to and from the standard library
SocketAddr
, SocketAddrV4
, and SocketAddrV6
types.
Implementations§
source§impl SockAddr
impl SockAddr
sourcepub const unsafe fn new(storage: sockaddr_storage, len: socklen_t) -> SockAddr
pub const unsafe fn new(storage: sockaddr_storage, len: socklen_t) -> SockAddr
Create a SockAddr
from the underlying storage and its length.
§Safety
Caller must ensure that the address family and length match the type of
storage address. For example if storage.ss_family
is set to AF_INET
the storage
must be initialised as sockaddr_in
, setting the content
and length appropriately.
§Examples
use std::io;
use std::mem;
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 mut addr_storage: libc::sockaddr_storage = unsafe { mem::zeroed() };
let mut len = mem::size_of_val(&addr_storage) as libc::socklen_t;
// The `getsockname(2)` system call will intiliase `storage` for
// us, setting `len` to the correct length.
let res = unsafe {
libc::getsockname(
socket.as_raw_fd(),
(&mut addr_storage as *mut libc::sockaddr_storage).cast(),
&mut len,
)
};
if res == -1 {
return Err(io::Error::last_os_error());
}
let address = unsafe { SockAddr::new(addr_storage, len) };
sourcepub unsafe fn try_init<F, T>(init: F) -> Result<(T, SockAddr)>
pub unsafe fn try_init<F, T>(init: F) -> Result<(T, SockAddr)>
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.
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.
§Safety
Caller must ensure that the address family and length match the type of
storage address. For example if storage.ss_family
is set to AF_INET
the storage
must be initialised as sockaddr_in
, setting the content
and length appropriately.
§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::try_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(())
}
})
}?;
sourcepub fn unix<P>(path: P) -> Result<SockAddr>
pub fn unix<P>(path: P) -> Result<SockAddr>
Constructs a SockAddr
with the family AF_UNIX
and the provided path.
Returns an error if the path is longer than SUN_LEN
.
sourcepub unsafe fn set_length(&mut self, length: socklen_t)
pub unsafe fn set_length(&mut self, length: socklen_t)
Set the length of the address.
§Safety
Caller must ensure that the address up to length
bytes are properly
initialised.
sourcepub const fn family(&self) -> sa_family_t
pub const fn family(&self) -> sa_family_t
Returns this address’s family.
sourcepub const fn as_storage(self) -> sockaddr_storage
pub const fn as_storage(self) -> sockaddr_storage
Retuns the address as the storage.
sourcepub const fn is_ipv4(&self) -> bool
pub const fn is_ipv4(&self) -> bool
Returns true if this address is in the AF_INET
(IPv4) family, false otherwise.
sourcepub const fn is_ipv6(&self) -> bool
pub const fn is_ipv6(&self) -> bool
Returns true if this address is in the AF_INET6
(IPv6) family, false
otherwise.
sourcepub fn is_unix(&self) -> bool
pub fn is_unix(&self) -> bool
Returns true if this address is of a unix socket (for local interprocess communication),
i.e. it is from the AF_UNIX
family, false otherwise.
sourcepub fn as_socket(&self) -> Option<SocketAddr>
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
.
sourcepub fn as_socket_ipv4(&self) -> Option<SocketAddrV4>
pub fn as_socket_ipv4(&self) -> Option<SocketAddrV4>
Returns this address as a SocketAddrV4
if it is in the AF_INET
family.
sourcepub fn as_socket_ipv6(&self) -> Option<SocketAddrV6>
pub fn as_socket_ipv6(&self) -> Option<SocketAddrV6>
Returns this address as a SocketAddrV6
if it is in the AF_INET6
family.
source§impl SockAddr
impl SockAddr
Unix only API.
sourcepub fn vsock(cid: u32, port: u32) -> SockAddr
pub fn vsock(cid: u32, port: u32) -> SockAddr
Constructs a SockAddr
with the family AF_VSOCK
and the provided CID/port.
§Errors
This function can never fail. In a future version of this library it will be made infallible.
sourcepub fn as_vsock_address(&self) -> Option<(u32, u32)>
pub fn as_vsock_address(&self) -> Option<(u32, u32)>
Returns this address VSOCK CID/port if it is in the AF_VSOCK
family,
otherwise return None
.
sourcepub fn is_unnamed(&self) -> bool
pub fn is_unnamed(&self) -> bool
Returns true if this address is an unnamed address from the AF_UNIX
family (for local
interprocess communication), false otherwise.
sourcepub fn as_unix(&self) -> Option<SocketAddr>
pub fn as_unix(&self) -> Option<SocketAddr>
Returns this address as Unix SocketAddr
if it is an AF_UNIX
pathname
address, otherwise returns None
.
sourcepub fn as_pathname(&self) -> Option<&Path>
pub fn as_pathname(&self) -> Option<&Path>
Returns this address as a Path
reference if it is an AF_UNIX
pathname address, otherwise returns None
.
sourcepub fn as_abstract_namespace(&self) -> Option<&[u8]>
pub fn as_abstract_namespace(&self) -> Option<&[u8]>
Returns this address as a slice of bytes representing an abstract address if it is an
AF_UNIX
abstract address, otherwise returns None
.
Abstract addresses are a Linux extension, so this method returns None
on all non-Linux
platforms.
Trait Implementations§
source§impl From<SocketAddr> for SockAddr
impl From<SocketAddr> for SockAddr
source§fn from(addr: SocketAddr) -> SockAddr
fn from(addr: SocketAddr) -> SockAddr
source§impl From<SocketAddrV4> for SockAddr
impl From<SocketAddrV4> for SockAddr
source§fn from(addr: SocketAddrV4) -> SockAddr
fn from(addr: SocketAddrV4) -> SockAddr
source§impl From<SocketAddrV6> for SockAddr
impl From<SocketAddrV6> for SockAddr
source§fn from(addr: SocketAddrV6) -> SockAddr
fn from(addr: SocketAddrV6) -> SockAddr
source§impl PartialEq for SockAddr
impl PartialEq for SockAddr
impl Eq for SockAddr
Auto Trait Implementations§
impl Freeze for SockAddr
impl RefUnwindSafe for SockAddr
impl Send for SockAddr
impl Sync for SockAddr
impl Unpin for SockAddr
impl UnwindSafe for SockAddr
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)