Struct Fat32FileObject 

pub struct Fat32FileObject {
    node: Arc<Fat32Node>,
    position: RwLock<usize>,
    parent_cluster: u32,
    dirty: Mutex<bool>,
    mmap_backing: RwLock<Option<Box<[Page]>>>,
    mmap_backing_len: Mutex<usize>,
    mmap_ranges: RwLock<BTreeMap<usize, MmapRange>>,
}

FAT32 file object for regular files

Fields

node: Arc<Fat32Node>

Reference to the FAT32 node

position: RwLock<usize>

Current file position

parent_cluster: u32

Parent directory cluster (for directory entry updates)

dirty: Mutex<bool>

File-level dirty flag to avoid unnecessary writeback

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 Fat32FileObject

pub fn new(node: Arc<Fat32Node>, parent_cluster: u32) -> Self

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

Write back current page-cache-backed content to disk if dirty.

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

fn update_directory_entry( &self, fat32_fs: &Fat32FileSystem, cluster: u32, size: usize, ) -> Result<(), StreamError>

Update the directory entry for this file

Trait Implementations

impl ControlOps for Fat32FileObject

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 Fat32FileObject

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

Formats the value using the given formatter.

impl Drop for Fat32FileObject

fn drop(&mut self)

Executes the destructor for this type.

impl FileObject for Fat32FileObject

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, from: SeekFrom) -> Result<u64, StreamError>

Seek to a position in the file stream

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

Get metadata about the file

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

Synchronize file content to storage

fn as_any(&self) -> &dyn Any

impl MemoryMappingOps for Fat32FileObject

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 Fat32FileObject

fn cache_id(&self) -> CacheId

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

impl Selectable for Fat32FileObject

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 Fat32FileObject

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