[−][src]Struct romio::uds::UnixListener
A Unix socket which can accept connections from other Unix sockets.
Examples
use romio::uds::{UnixListener, UnixStream}; use futures::prelude::*; async fn say_hello(mut stream: UnixStream) { stream.write_all(b"Shall I hear more, or shall I speak at this?!").await; } async fn listen() -> Result<(), Box<dyn std::error::Error + 'static>> { let listener = UnixListener::bind("/tmp/sock")?; let mut incoming = listener.incoming(); // accept connections and process them serially while let Some(stream) = incoming.next().await { say_hello(stream?).await; } Ok(()) }
Methods
impl UnixListener
[src]
pub fn bind(path: impl AsRef<Path>) -> Result<UnixListener>
[src]
Creates a new UnixListener
bound to the specified path.
Examples
Create a Unix Domain Socket on /tmp/sock
.
use romio::uds::UnixListener; let socket = UnixListener::bind("/tmp/sock")?;
pub fn local_addr(&self) -> Result<SocketAddr>
[src]
Returns the local socket address of this listener.
Examples
use romio::uds::UnixListener; let socket = UnixListener::bind("/tmp/sock")?; let addr = socket.local_addr()?;
pub fn incoming(self) -> Incoming
[src]
Consumes this listener, returning a stream of the sockets this listener accepts.
This method returns an implementation of the Stream
trait which
resolves to the sockets the are accepted on this listener.
Examples
use romio::uds::UnixListener; use futures::prelude::*; let listener = UnixListener::bind("/tmp/sock")?; let mut incoming = listener.incoming(); // accept connections and process them serially while let Some(stream) = incoming.next().await { match stream { Ok(stream) => { println!("new client!"); }, Err(e) => { /* connection failed */ } } }
Trait Implementations
impl Debug for UnixListener
[src]
impl AsRawFd for UnixListener
[src]
impl AsyncReady for UnixListener
[src]
type Ok = (UnixStream, SocketAddr)
The type of successful values yielded by this trait.
type Err = Error
The type of failures yielded by this trait.
fn poll_ready(
self: Pin<&mut Self>,
cx: &mut Context
) -> Poll<Result<Self::Ok, Self::Err>>
[src]
self: Pin<&mut Self>,
cx: &mut Context
) -> Poll<Result<Self::Ok, Self::Err>>
Check if the stream can be read from.
fn poll_ready_unpin(
&mut self,
cx: &mut Context
) -> Poll<Result<Self::Ok, Self::Err>> where
Self: Unpin,
[src]
&mut self,
cx: &mut Context
) -> Poll<Result<Self::Ok, Self::Err>> where
Self: Unpin,
impl TakeError for UnixListener
[src]
type Ok = Error
The type of successful values yielded by this trait.
type Err = Error
The type of failures yielded by this trait.
fn take_error(&self) -> Result<Option<Self::Ok>, Self::Err>
[src]
Returns the value of the SO_ERROR
option.
Examples
use romio::uds::UnixListener; use romio::raw::TakeError; let listener = UnixListener::bind("/tmp/sock")?; if let Ok(Some(err)) = listener.take_error() { println!("Got error: {:?}", err); }
Auto Trait Implementations
impl Unpin for UnixListener
impl Sync for UnixListener
impl Send for UnixListener
impl !UnwindSafe for UnixListener
impl !RefUnwindSafe for UnixListener
Blanket Implementations
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,