Struct Socket 

pub struct Socket { /* private fields */ }

An owned socket file descriptor. Closes itself on drop via our own close.

Implementations

impl Socket

pub fn raw(&self) -> i32

The raw file descriptor. Borrowed — the Socket retains ownership.

pub unsafe fn from_raw_fd(fd: i32) -> Socket

Wrap an already-open fd (e.g. one accepted by io_uring) into an owning Socket that closes it on drop.

Safety

fd must be a valid open descriptor whose ownership is transferred here.

pub fn accept(&self) -> Result<Socket>

Accept one inbound connection. On a non-blocking listener with no pending connection this returns Err with kind WouldBlock.

pub fn read(&self, buf: &mut [u8]) -> Result<usize>

Read into buf, returning the byte count (0 == EOF). Retries on EINTR. On a non-blocking socket with no data, returns WouldBlock.

pub fn write(&self, buf: &[u8]) -> Result<usize>

A single write syscall; may write fewer bytes than requested, or return WouldBlock on a full non-blocking socket. Retries on EINTR.

pub fn write_all(&self, buf: &[u8]) -> Result<()>

Write the whole buffer (blocking-socket convenience).

pub fn set_nonblocking(&self) -> Result<()>

Put the socket into non-blocking mode (O_NONBLOCK).

pub fn set_nodelay(&self) -> Result<()>

Disable Nagle’s algorithm (TCP_NODELAY) for low-latency replies.

pub fn local_port(&self) -> Result<u16>

The local port this socket is bound to (host byte order).

Trait Implementations

impl Drop for Socket

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.