Struct Handle 

pub struct Handle { /* private fields */ }

An open, classified handle to a filesystem entry obtained via O_PATH|O_NOFOLLOW.

The fd is opened with O_PATH, so it cannot be used for reading; it exists solely to identify the entry (for further openat calls relative to it) and to carry the stat snapshot. A symlink entry is never followed: it yields a Handle with kind() == EntryKind::Symlink.

Implementations

impl Handle

pub fn kind(&self) -> EntryKind

The entry’s classification (File / Dir / Symlink / Special).

pub fn dev(&self) -> u64

The device number of the entry.

pub fn ino(&self) -> u64

The inode number of the entry.

pub fn meta(&self) -> &FileMeta

A snapshot of the entry’s metadata at the time the handle was opened.

pub fn as_fd(&self) -> BorrowedFd<'_>

Borrow the underlying file descriptor.

pub fn try_clone(&self) -> Result<Handle>

Duplicate this handle, sharing the same pinned inode via a dup’d (F_DUPFD_CLOEXEC) O_PATH file descriptor and copying the cached classification + stat snapshot.

This is a pure fd dup — it opens nothing, follows nothing, and stats nothing on the filesystem, so it preserves every TOCTOU property of the original O_PATH|O_NOFOLLOW handle (the clone pins the exact same inode and cannot be redirected by a concurrent rename/symlink swap). It lets a walk that classifies an entry once hand an owned handle to a deferred (post-order) step without a second openat/fstatat on the entry.

pub async fn read_symlink(&self, side: Side) -> Result<(PathBuf, FileMeta)>

Read this symlink’s target and metadata from the one pinned O_PATH fd: the target via the empty-path readlinkat (read_link_handle) and the metadata from this handle’s fstat snapshot. Both describe the same pinned inode, so they are a faithful pair (the symlink analogue of Dir::open_file_read’s (File, FileMeta)). Errors if the handle is not a symlink (the empty-path read requires a symlink fd).

Trait Implementations

impl Debug for Handle

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

Formats the value using the given formatter.