Struct FsFile 

pub struct FsFile<F: HandleBackend> { /* private fields */ }

Owned RAII file which does not borrow the client.

File operations use the owning client’s Vfsi implementation. Dropping an open file queues cleanup without waiting for the backend lock. Dropping the final connection owner can perform synchronous teardown. Use try_close when the close result matters.

Implementations

impl<F: HandleBackend> FsFile<F>

pub fn is_closed(&self) -> bool

Whether explicit close has completed successfully on this handle.

pub fn read_request_at(&self, offset: u64, length: usize) -> FsRead<'_, F>

pub fn path(&self) -> &Path

Name used at open, retained for diagnostics; not a current namespace lookup or proof of identity. Handle operations continue to use the opened object even if its pathname changes.

pub fn write_request_at<'a>( &'a self, offset: u64, data: &'a [u8], ) -> FsWrite<'a, F>

pub fn read_request_at_into<'a>( &'a self, offset: u64, buffer: &'a mut [u8], ) -> FsReadInto<'a, F>

pub fn try_close(&mut self) -> VfResult<()>

Attempt to close without consuming the handle. A failed close leaves the handle armed so the caller can reconcile or retry cleanup explicitly. After an ambiguous close failure, remote state is unknown: do not resume data I/O just because is_closed() is false. This is local ownership, not proof that the server still has the descriptor open.

pub fn close(self) -> VfResult<()>

Consume and close the handle. On failure, Drop queues cleanup for a later operation or explicit cleanup drain; use try_close to retain control.

Trait Implementations

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

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

Formats the value using the given formatter.

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

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

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

fn path(&self) -> &Path

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

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

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<()>

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.