Struct Ext2FileObject 

pub struct Ext2FileObject {
    inode_number: u32,
    file_id: u64,
    position: Mutex<u64>,
    size_override: Mutex<Option<usize>>,
    dirty: Mutex<bool>,
    filesystem: RwLock<Option<Weak<dyn FileSystemOperations>>>,
    mmap_backing: RwLock<Option<Box<[Page]>>>,
    mmap_backing_len: Mutex<usize>,
    mmap_ranges: RwLock<BTreeMap<usize, MmapRange>>,
}

ext2 File Object

Handles file operations for regular files in the ext2 filesystem.

Fields

inode_number: u32

Inode number of the file

file_id: u64

File ID

position: Mutex<u64>

Current position in the file

size_override: Mutex<Option<usize>>

Optional logical size override after in-memory writes (not yet flushed)

dirty: Mutex<bool>

Dirty flag indicating in-memory changes not yet persisted to disk

filesystem: RwLock<Option<Weak<dyn FileSystemOperations>>>

Weak reference to the filesystem

mmap_backing: RwLock<Option<Box<[Page]>>>

Page-aligned backing for mmap operations (lazy initialized)

mmap_backing_len: Mutex<usize>

Byte length of the mmap backing (file size snapshot)

mmap_ranges: RwLock<BTreeMap<usize, MmapRange>>

Active mmap ranges keyed by starting virtual address

Implementations

impl Ext2FileObject

pub fn new(inode_number: u32, file_id: u64) -> Self

Create a new ext2 file object

pub fn set_filesystem(&self, fs: Weak<dyn FileSystemOperations>)

Set the filesystem reference

pub fn file_id(&self) -> u64

Get the file ID

fn sync_to_disk(&self) -> Result<(), StreamError>

Flush current page-cache-backed content to disk.

fn effective_size(&self, inode_size: usize) -> usize

fn ensure_mmap_backing( &self, file_size: usize, required_size: usize, ) -> Result<(), StreamError>

Trait Implementations

impl ControlOps for Ext2FileObject

fn control(&self, command: u32, arg: usize) -> Result<i32, &'static str>

Perform a control operation

fn supported_control_commands(&self) -> Vec<(u32, &'static str)>

Get a list of supported control commands

impl Debug for Ext2FileObject

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

Formats the value using the given formatter.

impl Drop for Ext2FileObject

fn drop(&mut self)

Executes the destructor for this type.

impl FileObject for Ext2FileObject

fn metadata(&self) -> Result<FileMetadata, StreamError>

Get metadata about the file

fn read_at(&self, offset: u64, buffer: &mut [u8]) -> Result<usize, StreamError>

Read data from a specific offset without changing internal position

fn write_at(&self, offset: u64, buffer: &[u8]) -> Result<usize, StreamError>

Write data to a specific offset without changing internal position

fn truncate(&self, size: u64) -> Result<(), StreamError>

Truncate the file to the specified size

fn seek(&self, whence: SeekFrom) -> Result<u64, StreamError>

Seek to a position in the file stream

fn as_any(&self) -> &dyn Any

fn sync(&self) -> Result<(), StreamError>

Synchronize file content to storage

impl MemoryMappingOps for Ext2FileObject

fn get_mapping_info( &self, offset: usize, length: usize, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information for a region of the object

fn get_mapping_info_with( &self, offset: usize, length: usize, is_shared: bool, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information with sharing intent.

fn on_mapped( &self, _vaddr: usize, _paddr: usize, _length: usize, _offset: usize, )

Notification that a mapping has been created

fn on_unmapped(&self, vaddr: usize, _length: usize)

Notification that a mapping has been removed

fn supports_mmap(&self) -> bool

Check if memory mapping is supported

fn resolve_fault( &self, access: &AccessKind, map: &VirtualMemoryMap, ) -> Result<ResolveFaultResult, ResolveFaultError>

fn mmap_owner_name(&self) -> String

Diagnostic helper: return a short owner name for logging

impl PageCacheCapable for Ext2FileObject

fn cache_id(&self) -> CacheId

Returns a stable CacheId for this file for the lifetime of the underlying filesystem instance.

impl Selectable for Ext2FileObject

fn current_ready(&self, interest: ReadyInterest) -> ReadySet

Return current readiness for the given interest set.

fn wait_until_ready( &self, _interest: ReadyInterest, _trapframe: &mut Trapframe, _timeout_ticks: Option<u64>, ) -> SelectWaitOutcome

Block the current task using the provided trapframe until the interest becomes ready or the optional timeout (in ticks) expires.

fn is_nonblocking(&self) -> bool

Query whether non-blocking I/O semantics are enabled on this object.

fn set_nonblocking(&self, _enabled: bool)

Enable or disable non-blocking I/O semantics on this object.

impl StreamOps for Ext2FileObject

fn read(&self, buffer: &mut [u8]) -> Result<usize, StreamError>

Read data from the stream

fn write(&self, buffer: &[u8]) -> Result<usize, StreamError>

Write data to the stream