Struct OpenFile 

pub struct OpenFile {
    scheme: DynScheme,
    file_id: u64,
    path: String,
    offset: SpinLock<u64>,
    open_flags: OpenFlags,
    file_flags: FileFlags,
    size: Option<u64>,
}

An open file handle.

Fields

scheme: DynScheme

Scheme handling this file.

file_id: u64

File ID within the scheme.

path: String

Original path (for debugging).

offset: SpinLock<u64>

Current read/write offset.

open_flags: OpenFlags

Flags from open().

file_flags: FileFlags

File properties.

size: Option<u64>

Cached file size (if known).

Implementations

impl OpenFile

pub fn new( scheme: DynScheme, file_id: u64, path: String, open_flags: OpenFlags, file_flags: FileFlags, size: Option<u64>, ) -> Self

Create a new open file.

pub fn read(&self, buf: &mut [u8]) -> Result<usize, SyscallError>

Read from the file at current offset, advancing the offset.

pub fn write(&self, buf: &[u8]) -> Result<usize, SyscallError>

Write to the file at current offset, advancing the offset.

pub fn pread(&self, offset: u64, buf: &mut [u8]) -> Result<usize, SyscallError>

Read at a specific offset without changing current offset (pread).

pub fn pwrite(&self, offset: u64, buf: &[u8]) -> Result<usize, SyscallError>

Write at a specific offset without changing current offset (pwrite).

pub fn seek(&self, new_offset: u64) -> Result<u64, SyscallError>

Seek to a new offset (absolute).

pub fn lseek(&self, off: i64, whence: u32) -> Result<u64, SyscallError>

POSIX lseek: whence=0 SET, 1 CUR, 2 END.

pub fn tell(&self) -> u64

Get current offset.

pub fn size(&self) -> Result<u64, SyscallError>

Get file size.

pub fn sync(&self) -> Result<(), SyscallError>

Sync file to storage.

pub fn close(&self) -> Result<(), SyscallError>

Signal that this file descriptor is being closed.

Does NOT call scheme.close() directly; the actual scheme close is deferred to the Drop impl so it fires only when the last Arc is released (POSIX: scheme is closed when all dup’d/fork’d copies are gone).

pub fn flags(&self) -> FileFlags

Get file flags.

pub fn open_flags(&self) -> OpenFlags

Get open flags.

pub fn path(&self) -> &str

Get path (for debugging).

pub fn stat(&self) -> Result<FileStat, SyscallError>

Get file metadata.

pub fn readdir(&self) -> Result<Vec<DirEntry>, SyscallError>

List directory entries (only valid for directories).

pub fn file_id(&self) -> u64

Get internal file_id (for scheme delegation).

pub fn scheme(&self) -> &DynScheme

Get the underlying scheme.

Trait Implementations

impl Drop for OpenFile

fn drop(&mut self)

Performs the drop operation.

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.