Struct ListOptions 

pub struct ListOptions {

    pub all: bool,
    pub almost_all: bool,
    pub sort_by: SortBy,
    pub reverse: bool,
    pub dirs_first: bool,
    pub recursive: bool,
    pub max_depth: Option<usize>,
    pub gnu_mode: bool,
    pub follow_links: bool,
    pub directory: bool,
    pub ignore_backups: bool,
    pub ignore_patterns: Vec<String>,
    pub hide_patterns: Vec<String>,
    pub use_ignore_files: bool,
    pub list_archives: bool,
    pub time_field: TimeField,
    pub cli_symlink: CliSymlinkMode,
    pub parallel: bool,
    pub threads: usize,
    pub collect_timing: bool,
    pub resolve_owner_group: bool,
    pub read_selinux: bool,
    pub linux_statx: bool,
    pub io_uring: bool,
    pub emit_dir_headers: bool,
}

Options controlling which entries appear and how they are ordered.

Fields

all: bool

almost_all: bool

sort_by: SortBy

reverse: bool

dirs_first: bool

recursive: bool

max_depth: Option<usize>

gnu_mode: bool

Stricter GNU-compatible behavior.

follow_links: bool

Follow symlinks when stating (-L).

directory: bool

List directories themselves, not contents (-d).

ignore_backups: bool

Hide *~ backup names (-B).

ignore_patterns: Vec<String>

Shell-style ignore patterns (-I / --ignore); always hidden.

hide_patterns: Vec<String>

Shell-style hide patterns (--hide); hidden unless -a/-A.

use_ignore_files: bool

When true, honor .gitignore / .f00ignore in listed directories.

list_archives: bool

When true, list inside zip/tar archives when a path is an archive file. (Applied by callers that integrate f00-archive; core itself does not open archives.)

time_field: TimeField

Which timestamp to sort/display by.

cli_symlink: CliSymlinkMode

How CLI path arguments that are symlinks are handled.

parallel: bool

Parallelize metadata (stat) for large directories (rayon). Forced off when Self::threads is 1.

threads: usize

Rayon worker count: 0 = auto, 1 = force serial, N>1 = fixed pool size.

collect_timing: bool

When true, fill crate::Listing::timing with phase durations.

resolve_owner_group: bool

Resolve uid/gid to owner/group names (expensive NSS). Off for short listings.

read_selinux: bool

Read SELinux context xattr (-Z). Off unless requested.

linux_statx: bool

Prefer Linux statx for metadata when available (ignored on other OSes).

io_uring: bool

Prefer io_uring batch statx for large directories when the io-uring cargo feature is enabled (Linux only; ignored otherwise).

emit_dir_headers: bool

Emit synthetic directory section headers in recursive listings (-R). Off for --tree (headers are not used and cost extra work).

Implementations

impl ListOptions

pub fn use_parallel_stat(&self, entry_count: usize) -> bool

Whether metadata should use rayon for this listing size.

Trait Implementations

impl Clone for ListOptions

fn clone(&self) -> ListOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ListOptions

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

Formats the value using the given formatter.

impl Default for ListOptions

fn default() -> Self

Returns the “default value” for a type.