Struct TmpFileObject 

pub struct TmpFileObject {
    node: Arc<TmpNode>,
    position: RwLock<u64>,
    device_guard: Option<Arc<dyn Device>>,
    socket_ref: Option<Arc<dyn SocketObject>>,
    mmap_backing: RwLock<Option<Box<[Page]>>>,
    mmap_backing_len: Mutex<usize>,
    mmap_ranges: RwLock<BTreeMap<usize, MmapRange>>,
}

File object for TmpFS operations

TmpFileObject represents an open file or directory in TmpFS.

It maintains the current file position and, for device files, an optional device guard. For socket files, it maintains a reference to the socket object.

Fields

node: Arc<TmpNode>

Reference to the TmpNode

position: RwLock<u64>

Current file position

device_guard: Option<Arc<dyn Device>>

Optional device guard for device files

socket_ref: Option<Arc<dyn SocketObject>>

Optional socket reference for socket files

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

Page-aligned backing for private mmap operations

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 TmpFileObject

pub fn new_regular(node: Arc<TmpNode>) -> Self

Create a new file object for regular files

pub fn new_directory(node: Arc<TmpNode>) -> Self

Create a new file object for directories

pub fn new_device(node: Arc<TmpNode>, info: DeviceFileInfo) -> Self

Create a new file object for device files

pub fn new_socket(node: Arc<TmpNode>, info: SocketFileInfo) -> Self

Create a new file object for socket files

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

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

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

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

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

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

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

Trait Implementations

impl ControlOps for TmpFileObject

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 FileObject for TmpFileObject

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 seek(&self, pos: SeekFrom) -> Result<u64, StreamError>

Seek to a position in the file stream

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

Get metadata about the file

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

Truncate the file to the specified size

fn as_any(&self) -> &dyn Any

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

Synchronize file content to storage

impl MemoryMappingOps for TmpFileObject

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 TmpFileObject

fn cache_id(&self) -> CacheId

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

impl Selectable for TmpFileObject

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 current_ready(&self, interest: ReadyInterest) -> ReadySet

Return current readiness for the given interest set.

fn set_nonblocking(&self, _enabled: bool)

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

fn is_nonblocking(&self) -> bool

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

impl StreamOps for TmpFileObject

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