Trait FileHandle 

pub trait FileHandle {
    // Required methods
    fn path(&self) -> &Path;
    fn try_close(&mut self) -> Result<(), VfError>;
    fn is_closed(&self) -> bool;
    fn close(self) -> Result<(), VfError>
       where Self: Sized;
}

Owned application file. Borrowed requests preserve the file’s lifetime; clients validate connection ownership before dispatching a vector.

Clients validate ownership before I/O and report positional progress. Standard-I/O adapters manage their own independent cursors. ReadOp borrows handles directly; constructing it does no I/O. A backend must retain ownership of live descriptors through cleanup failures.

Required Methods

fn path(&self) -> &Path

Diagnostic name captured at open; not current path or object identity.

fn try_close(&mut self) -> Result<(), VfError>

Close without surrendering cleanup ownership on failure. After an ambiguous failure, reconcile/close rather than resume ordinary I/O.

fn is_closed(&self) -> bool

Local close ownership only, not proof of remote liveness after failure.

fn close(self) -> Result<(), VfError>

where Self: Sized,

Consuming close: on failure the handle is lost and Drop retries cleanup best-effort on a later operation or cleanup drain. Prefer try_close when cleanup failures need reconciliation.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl<F: HandleBackend> FileHandle for FsFile<F>