Enum FileOperand 

#[non_exhaustive]
pub enum FileOperand {
    Cwd,
    Fd(Fd),
    Path {
        base: VfPathBase,
        path: PathBuf,
    },
    CwdPath(PathBuf),
    Saved,
}

Native backend operand: a File Descriptor, path, or special directory target.

This selects an operation target without owning its open instance. Cloning a File Descriptor operand neither duplicates the open instance nor acquires cleanup ownership. Application callers use crate::api::Target instead.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Cwd

The client’s current working directory (a stat target, but not a file for read/write). Also the Default placeholder.

Fd(Fd)

Backend-assigned File Descriptor referring to an existing open instance.

Path

A path; the VfPathBase records whether it is absolute or relative to the client’s cwd. Note that the raw path (see path) does not itself record the base; the filesystem resolves it while honoring this field.

Fields

base: VfPathBase

path: PathBuf

CwdPath(PathBuf)

A path relative to the client’s current working directory.

Saved

The saved (previous) directory, mirroring the C sentinel. No current backend produces or consumes this; operations on it fail.

Implementations

impl FileOperand

pub fn from_path(path: &str) -> FileOperand

pub fn from_path_bytes(path: &[u8]) -> FileOperand

Construct from arbitrary Unix path bytes.

pub fn from_os_path(path: &Path) -> FileOperand

Construct from a native Unix path.

pub fn from_fd(fd: Fd) -> FileOperand

pub fn cwd() -> FileOperand

VF_FILE_CURRENT: the client’s current working directory itself.

pub fn cwd_path(path: impl Into<PathBuf>) -> FileOperand

A path relative to the client’s current working directory.

pub fn saved() -> FileOperand

pub fn is_fd(&self) -> bool

Whether this references an open File Descriptor.

pub fn fd(&self) -> Option<Fd>

The File Descriptor, if this operand is Self::Fd.

pub fn path(&self) -> Option<&Path>

The raw path, for Path and CwdPath. This does not resolve VfPathBase or the client working directory.

pub fn path_bytes(&self) -> Option<&[u8]>

The raw bytes of this path, if path-backed.

Trait Implementations

impl Clone for FileOperand

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileOperand

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

Formats the value using the given formatter.

impl Default for FileOperand

fn default() -> Self

Returns the “default value” for a type.

impl Eq for FileOperand

impl PartialEq for FileOperand

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FileOperand