Struct romio::uds::UnixStream

pub struct UnixStream { /* fields omitted */ }

A structure representing a connected Unix socket.

This socket can be connected directly with UnixStream::connect or accepted from a listener with UnixListener::incoming. Additionally, a pair of anonymous Unix sockets can be created with UnixStream::pair.

Methods

impl UnixStream

pub fn connect(path: impl AsRef<Path>) -> ConnectFuture

Connects to the socket named by path.

This function will create a new Unix socket and connect to the path specified, associating the returned stream with the default event loop's handle.

Examples

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;

let stream = await!(UnixStream::connect("/tmp/sock"));

pub fn pair() -> Result<(UnixStream, UnixStream)>

Creates an unnamed pair of connected sockets.

This function will create a pair of interconnected Unix sockets for communicating back and forth between one another. Each socket will be associated with the event loop whose handle is also provided.

Examples

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;

let (sock1, sock2) = UnixStream::pair()?;

pub fn poll_read_ready(&self, waker: &Waker) -> Poll<Result<Ready>>

Test whether this socket is ready to be read or not.

pub fn poll_write_ready(&self, waker: &Waker) -> Poll<Result<Ready>>

Test whether this socket is ready to be written to or not.

pub fn local_addr(&self) -> Result<SocketAddr>

Returns the socket address of the local half of this connection.

Examples

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;

let stream = await!(UnixStream::connect("/tmp/sock"))?;
let addr = stream.local_addr()?;

pub fn peer_addr(&self) -> Result<SocketAddr>

Returns the socket address of the remote half of this connection.

Examples

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;

let stream = await!(UnixStream::connect("/tmp/sock"))?;
let addr = stream.peer_addr()?;

pub fn peer_cred(&self) -> Result<UCred>

Returns effective credentials of the process which called connect or socketpair.

Examples

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;

let stream = await!(UnixStream::connect("/tmp/sock"))?;
let cred = stream.peer_cred()?;

pub fn take_error(&self) -> Result<Option<Error>>

Returns the value of the SO_ERROR option.

Examples

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;

let stream = await!(UnixStream::connect("/tmp/sock"))?;
if let Ok(Some(err)) = stream.take_error() {
    println!("Got error: {:?}", err);
}

pub fn shutdown(&self, how: Shutdown) -> Result<()>

Shuts down the read, write, or both halves of this connection.

This function will cause all pending and future I/O calls on the specified portions to immediately return with an appropriate value (see the documentation of Shutdown).

#![feature(async_await, await_macro, futures_api)]
use romio::uds::UnixStream;
use std::net::Shutdown;

let stream = await!(UnixStream::connect("/tmp/sock"))?;
stream.shutdown(Shutdown::Both)?;

Trait Implementations

impl Debug for UnixStream

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

Formats the value using the given formatter.

impl AsRawFd for UnixStream

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl AsyncRead for UnixStream

fn poll_read(&mut self, waker: &Waker, buf: &mut [u8]) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into buf.

fn poll_vectored_read(
    &mut self,
    waker: &Waker,
    vec: &mut [&mut IoVec]
) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into vec using vectored IO operations.

unsafe fn initializer(&self) -> Initializer

Determines if this AsyncReader can work with buffers of uninitialized memory.

impl<'a> AsyncRead for &'a UnixStream

fn poll_read(&mut self, waker: &Waker, buf: &mut [u8]) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into buf.

fn poll_vectored_read(
    &mut self,
    waker: &Waker,
    bufs: &mut [&mut IoVec]
) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into vec using vectored IO operations.

unsafe fn initializer(&self) -> Initializer

Determines if this AsyncReader can work with buffers of uninitialized memory.

impl AsyncWrite for UnixStream

fn poll_write(&mut self, waker: &Waker, buf: &[u8]) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_vectored_write(
    &mut self,
    waker: &Waker,
    vec: &[&IoVec]
) -> Poll<Result<usize>>

Attempt to write bytes from vec into the object using vectored IO operations.

fn poll_flush(&mut self, waker: &Waker) -> Poll<Result<()>>

Attempt to flush the object, ensuring that any buffered data reach their destination.

fn poll_close(&mut self, waker: &Waker) -> Poll<Result<()>>

Attempt to close the object.

impl<'a> AsyncWrite for &'a UnixStream

fn poll_write(&mut self, waker: &Waker, buf: &[u8]) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_vectored_write(
    &mut self,
    waker: &Waker,
    bufs: &[&IoVec]
) -> Poll<Result<usize>>

Attempt to write bytes from vec into the object using vectored IO operations.

fn poll_flush(&mut self, waker: &Waker) -> Poll<Result<()>>

Attempt to flush the object, ensuring that any buffered data reach their destination.

fn poll_close(&mut self, waker: &Waker) -> Poll<Result<()>>

Attempt to close the object.