Struct Fd 

pub struct Fd(/* private fields */);

An owned file descriptor that closes on drop.

Fd is move-only. Constructing one from a raw descriptor transfers close ownership to Fd; do not also close the raw descriptor elsewhere.

Implementations

impl Fd

pub unsafe fn from_owned_raw_fd( fd: RawFd, op: &'static str, ) -> Result<Self, CoreError>

Wrap an owned raw file descriptor.

Safety

The caller must guarantee fd is valid, open, and uniquely owned by the returned Fd. Passing a borrowed fd, or closing fd after this call, can cause double-close or use-after-close bugs.

pub fn eventfd(init: u32) -> Result<Self, CoreError>

Create a non-blocking eventfd.

pub fn timerfd() -> Result<Self, CoreError>

Create a non-blocking timerfd using CLOCK_MONOTONIC.

pub fn dup2(&self, target: RawFd) -> Result<(), CoreError>

Perform a dup2 syscall.

pub fn set_nonblock(&self) -> Result<(), CoreError>

Set the O_NONBLOCK flag on the descriptor.

pub fn set_cloexec(&self) -> Result<(), CoreError>

Set the FD_CLOEXEC flag on the descriptor.

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

Read bytes into a mutable slice.

Returns Ok(None) if the operation would block (EAGAIN).

pub fn seek_set(&self, offset: i64) -> Result<u64, CoreError>

Seek to an absolute file offset.

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

Write bytes from a slice.

Returns Ok(None) if the operation would block (EAGAIN).

pub fn read_u64(&self) -> Result<Option<u64>, CoreError>

Read a native-endian u64.

Returns Ok(None) if the operation would block (EAGAIN).

pub fn write_u64(&self, value: u64) -> Result<Option<usize>, CoreError>

Write a native-endian u64.

Returns Ok(None) if the operation would block (EAGAIN).

pub fn set_timer_oneshot( &self, delay: Option<Duration>, ) -> Result<(), CoreError>

Arm or disarm a one-shot timerfd.

Passing None disarms the timer. Zero durations are rounded up to one nanosecond so the timer still expires.

Trait Implementations

impl AsRawFd for Fd

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Drop for Fd

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.