Struct uds::UnixSeqpacketListener

#[repr(transparent)]
pub struct UnixSeqpacketListener { /* fields omitted */ }

An unix domain listener for sequential packet connections.

See UnixSeqpacketConn for a description of this type of connection.

Examples

let listener = uds::UnixSeqpacketListener::bind("seqpacket_listener.socket")
    .expect("Create seqpacket listener");
let _client = uds::UnixSeqpacketConn::connect("seqpacket_listener.socket").unwrap();
let (conn, _addr) = listener.accept_unix_addr().unwrap();
conn.send(b"Welcome").unwrap();

Methods

impl UnixSeqpacketListener

pub fn bind<P: AsRef<Path>>(path: P) -> Result<Self, Error>

pub fn bind_unix_addr(addr: &UnixSocketAddr) -> Result<Self, Error>

pub fn local_unix_addr(&self) -> Result<UnixSocketAddr, Error>

pub fn accept_unix_addr(
    &self
) -> Result<(UnixSeqpacketConn, UnixSocketAddr), Error>

pub fn try_clone(&self) -> Result<Self, Error>

Create a new file descriptor listening for the same connections.

pub fn set_nonblocking(&self, nonblocking: bool) -> Result<(), Error>

Enable or disable nonblocking-ness of [accept_unix_addr()](#method.accept_unix addr).

The returned connnections will still be in blocking mode regardsless.

Consider using the nonblocking variant of this type instead; this method mostly exists for feature parity with std's UnixListener.

Examples

let listener = UnixSeqpacketListener::bind_unix_addr(&addr).expect("create listener");
listener.set_nonblocking(true).expect("enable noblocking mode");
assert_eq!(listener.accept_unix_addr().unwrap_err().kind(), ErrorKind::WouldBlock);

Trait Implementations

impl AsRawFd for UnixSeqpacketListener

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for UnixSeqpacketListener

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Drop for UnixSeqpacketListener

fn drop(&mut self)

Executes the destructor for this type.

impl FromRawFd for UnixSeqpacketListener

unsafe fn from_raw_fd(fd: RawFd) -> Self

Constructs a new instance of Self from the given raw file descriptor.

impl IntoRawFd for UnixSeqpacketListener

fn into_raw_fd(self) -> RawFd

Consumes this object, returning the raw underlying file descriptor.