Struct Entry 

pub struct Entry {

    pub path: PathBuf,
    pub name: String,
    pub kind: EntryKind,
    pub size: u64,
    pub modified: Option<SystemTime>,
    pub created: Option<SystemTime>,
    pub accessed: Option<SystemTime>,
    pub changed: Option<SystemTime>,
    pub mode: u32,
    pub readonly: bool,
    pub symlink_target: Option<PathBuf>,
    pub depth: usize,
    pub git_status: GitStatus,
    pub is_dir_header: bool,
    pub nlink: u64,
    pub uid: u32,
    pub gid: u32,
    pub inode: u64,
    pub blocks: u64,
    pub dev: u64,
    pub rdev: u64,
    pub blksize: u64,
    pub owner: String,
    pub group: String,
    pub author: String,
    pub context: String,
}

A single filesystem entry ready for formatting.

Fields

path: PathBuf

name: String

kind: EntryKind

size: u64

modified: Option<SystemTime>

created: Option<SystemTime>

accessed: Option<SystemTime>

changed: Option<SystemTime>

Status-change time (st_ctime) when available.

mode: u32

Permission mode bits (unix) or 0 on platforms without them.

readonly: bool

symlink_target: Option<PathBuf>

depth: usize

git_status: GitStatus

is_dir_header: bool

True when this entry is a directory listing header (for recursive mode).

nlink: u64

Hard link count (st_nlink).

uid: u32

gid: u32

inode: u64

blocks: u64

Allocated blocks in 512-byte units (GNU ls -s style) when known.

dev: u64

Device ID containing the file (st_dev / stx_dev).

rdev: u64

Device ID (if special file) (st_rdev / stx_rdev).

blksize: u64

Preferred I/O block size (st_blksize / stx_blksize) when known.

owner: String

Owner name (or numeric string).

group: String

Group name (or numeric string).

author: String

Author (GNU --author); typically same as owner on Linux.

context: String

SELinux security context (-Z); empty if unavailable.

Implementations

impl Entry

pub fn from_path(path: impl AsRef<Path>, depth: usize) -> Result<Self>

pub fn from_path_with( path: impl AsRef<Path>, depth: usize, fill: MetaFill, ) -> Result<Self>

pub fn from_path_follow(path: impl AsRef<Path>, depth: usize) -> Result<Self>

Like [from_path] but follow the final symlink target for metadata (-L).

pub fn from_path_follow_with( path: impl AsRef<Path>, depth: usize, fill: MetaFill, ) -> Result<Self>

pub fn from_path_and_meta( path: &Path, meta: &Metadata, depth: usize, ) -> Result<Self>

pub fn from_path_and_meta_with( path: &Path, meta: &Metadata, depth: usize, fill: MetaFill, ) -> Result<Self>

pub fn dir_header(path: impl AsRef<Path>, depth: usize) -> Self

Create a synthetic directory header for recursive listings.

pub fn is_hidden(&self) -> bool

pub fn is_dir(&self) -> bool

pub fn type_detail(&self) -> &'static str

Fine-grained type string for machine formats (file, fifo, socket, …).

pub fn is_executable(&self) -> bool

pub fn dev_major_minor(&self) -> (u32, u32)

(major, minor) for st_dev.

pub fn rdev_major_minor(&self) -> (u32, u32)

(major, minor) for st_rdev (special files).

pub fn xattr_names(&self) -> Vec<String>

Extended attribute names (listxattr); empty when unsupported or none.

pub fn mode_perms_octal(&self) -> String

Permission bits only (no file-type nibble), as octal string without leading type.

pub fn mode_full_octal(&self) -> String

Full mode including type bits when available.

pub fn modified_datetime(&self) -> Option<DateTime<Local>>

pub fn accessed_datetime(&self) -> Option<DateTime<Local>>

pub fn created_datetime(&self) -> Option<DateTime<Local>>

pub fn changed_datetime(&self) -> Option<DateTime<Local>>

pub fn time_for(&self, field: TimeField) -> Option<SystemTime>

pub fn datetime_for(&self, field: TimeField) -> Option<DateTime<Local>>

pub fn extension(&self) -> Option<&str>

pub fn owner_display(&self, numeric: bool) -> String

Owner string for display (-n forces numeric).

pub fn group_display(&self, numeric: bool) -> String

pub fn author_display(&self, numeric: bool) -> String

pub fn fill_expensive(&mut self, fill: MetaFill)

Fill owner/group/author (and optional SELinux context) after a cheap stat.

Used so batch statx / io_uring can collect metadata first, then resolve expensive fields without re-statting.

Trait Implementations

impl Clone for Entry

fn clone(&self) -> Entry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Entry

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

Formats the value using the given formatter.