Struct LinuxRiscv64Abi 

pub struct LinuxRiscv64Abi {
    namespace: Arc<TaskNamespace>,
    fd_to_handle: Vec<Option<u32>>,
    fd_flags: Vec<u32>,
    file_status_flags: Vec<u32>,
    free_fds: Vec<usize>,
    pub signal_state: Arc<Mutex<SignalState>>,
    thread_state: LinuxThreadState,
    posix_timers: BTreeMap<u64, PosixTimer>,
    next_timer_id: u64,
}

Fields

namespace: Arc<TaskNamespace>

Task namespace for Linux PID/TID management

fd_to_handle: Vec<Option<u32>>

File descriptor to handle mapping table (fd -> handle) None means the fd is not allocated Vec to avoid stack overflow during initialization

fd_flags: Vec<u32>

File descriptor flags (e.g., FD_CLOEXEC) Vec to avoid stack overflow during initialization

file_status_flags: Vec<u32>

File status flags (e.g., O_NONBLOCK) for F_GETFL/F_SETFL Vec to avoid stack overflow during initialization

free_fds: Vec<usize>

Free file descriptor list for O(1) allocation/deallocation

signal_state: Arc<Mutex<SignalState>>

Signal handling state

thread_state: LinuxThreadState

Linux-specific per-task thread state (isolated inside ABI)

posix_timers: BTreeMap<u64, PosixTimer>

POSIX timers created via timer_create

next_timer_id: u64

Next timer identifier (Linux timer_t)

Implementations

impl LinuxRiscv64Abi

pub fn thread_state(&self) -> &LinuxThreadState

pub fn thread_state_mut(&mut self) -> &mut LinuxThreadState

pub fn allocate_fd(&mut self, handle: u32) -> Result<usize, &'static str>

Allocate a new file descriptor and map it to a handle

pub fn allocate_specific_fd( &mut self, fd: usize, handle: u32, ) -> Result<(), &'static str>

Allocate a specific file descriptor and map it to a handle

pub fn get_handle(&self, fd: usize) -> Option<u32>

Get handle from file descriptor

pub fn remove_fd(&mut self, fd: usize) -> Option<u32>

Remove file descriptor mapping and clear its flags

pub fn find_fd_by_handle(&self, handle: u32) -> Option<usize>

Find file descriptor by handle (linear search)

pub fn init_std_fds( &mut self, stdin_handle: u32, stdout_handle: u32, stderr_handle: u32, )

Initialize standard file descriptors (stdin, stdout, stderr)

pub fn get_fd_flags(&self, fd: usize) -> Option<u32>

Get file descriptor flags

pub fn set_fd_flags( &mut self, fd: usize, flags: u32, ) -> Result<(), &'static str>

Set file descriptor flags

pub fn get_file_status_flags(&self, fd: usize) -> Option<u32>

Get file status flags (F_GETFL)

pub fn set_file_status_flags( &mut self, fd: usize, flags: u32, ) -> Result<(), &'static str>

Set file status flags (F_SETFL)

pub fn fd_count(&self) -> usize

Get total number of allocated file descriptors

pub fn allocated_fds(&self) -> Vec<usize>

Get the list of allocated file descriptors (for debugging)

pub fn process_signals(&self, trapframe: &mut Trapframe) -> bool

Process pending signals and handle them according to Linux semantics Returns true if execution should be interrupted (signal handler called or process terminated)

pub fn handle_event_direct(&self, event: &Event)

Handle incoming event from Scarlet event system and convert to signal if applicable

pub fn has_pending_signals(&self) -> bool

Check if there are pending signals ready for delivery

pub fn allocate_posix_timer_id(&mut self) -> u64

Allocate a unique timer identifier for POSIX timers

pub fn store_posix_timer(&mut self, timer: PosixTimer)

Store a POSIX timer definition tracked by this ABI instance

pub fn get_posix_timer(&self, id: u64) -> Option<&PosixTimer>

Retrieve a reference to a stored POSIX timer

pub fn remove_posix_timer(&mut self, id: u64) -> Option<PosixTimer>

Remove a POSIX timer from this ABI instance

Trait Implementations

impl AbiModule for LinuxRiscv64Abi

fn name() -> &'static str

fn get_name(&self) -> String

fn clone_boxed(&self) -> Box<dyn AbiModule + Send + Sync>

Clone this ABI module into a boxed trait object

fn handle_syscall( &mut self, trapframe: &mut Trapframe, ) -> Result<usize, &'static str>

fn handle_event( &self, event: Event, target_task_id: u32, ) -> Result<(), &'static str>

Handle incoming event from EventManager

fn on_task_cloned( &mut self, _parent_task: &Task, _child_task: &Task, _flags: CloneFlags, ) -> Result<(), &'static str>

Hook invoked after Task::clone_task creates the child

fn on_task_exit(&mut self, task: &Task)

Hook invoked as part of Task::exit cleanup for the current task

fn get_task_namespace(&self) -> Arc<TaskNamespace>

Get the task namespace for this ABI.

fn can_execute_binary( &self, file_object: &KernelObject, file_path: &str, current_abi: Option<&(dyn AbiModule + Send + Sync)>, ) -> Option<u8>

Determine if a binary can be executed by this ABI and return confidence

fn execute_binary( &self, file_object: &KernelObject, argv: &[&str], envp: &[&str], task: &Task, trapframe: &mut Trapframe, ) -> Result<(), &'static str>

Binary execution (each ABI supports its own binary format)

fn get_default_cwd(&self) -> &str

Get default working directory for this ABI

fn setup_overlay_environment( &self, target_vfs: &Arc<VfsManager>, base_vfs: &Arc<VfsManager>, system_path: &str, config_path: &str, ) -> Result<(), &'static str>

Setup overlay environment for this ABI (read-only base + writable layer)

fn setup_shared_resources( &self, target_vfs: &Arc<VfsManager>, base_vfs: &Arc<VfsManager>, ) -> Result<(), &'static str>

Setup shared resources accessible across all ABIs

fn initialize_from_existing_handles( &mut self, _task: &Task, ) -> Result<(), &'static str>

Handle conversion when switching ABIs

fn normalize_env_to_scarlet(&self, _envp: &mut Vec<String>)

Convert environment variables from this ABI to Scarlet canonical format (in-place)

fn denormalize_env_from_scarlet(&self, _envp: &mut Vec<String>)

Convert environment variables from Scarlet canonical format to this ABI’s format (in-place)

fn choose_load_address( &self, _elf_type: u16, _target: LoadTarget, ) -> Option<u64>

Choose base address for ELF loading (ABI-specific strategy)

fn get_interpreter_path(&self, requested_interpreter: &str) -> String

Override interpreter path (for ABI compatibility)

fn get_runtime_config( &self, _file_object: &KernelObject, _file_path: &str, ) -> Option<RuntimeConfig>

Get userland runtime configuration for executing binaries

fn set_tls_pointer(&mut self, _ptr: usize)

Set the TLS (Thread Local Storage) pointer for this task

fn get_tls_pointer(&self) -> Option<usize>

Get the TLS (Thread Local Storage) pointer for this task

fn set_clear_child_tid(&mut self, _ptr: usize)

Set the clear_child_tid pointer for thread exit notification

impl Clone for LinuxRiscv64Abi

fn clone(&self) -> LinuxRiscv64Abi

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for LinuxRiscv64Abi

fn default() -> Self

Returns the “default value” for a type.