Struct ScarletAbi 

pub struct ScarletAbi {
    pub tls_pointer: Option<usize>,
    pub clear_child_tid_ptr: Option<usize>,
}

Fields

tls_pointer: Option<usize>

TLS (Thread Local Storage) pointer for this task

clear_child_tid_ptr: Option<usize>

clear_child_tid pointer for thread exit notification (Linux-compatible)

Implementations

impl ScarletAbi

pub fn tls_pointer(&self) -> Option<usize>

Get the TLS pointer for this task

pub fn set_tls_pointer(&mut self, ptr: usize)

Set the TLS pointer for this task

pub fn clear_tls_pointer(&mut self)

Clear the TLS pointer for this task

pub fn set_clear_child_tid(&mut self, ptr: usize)

Set the clear_child_tid pointer for thread exit notification

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

Handle task exit with TLS cleanup (Linux-compatible)

impl ScarletAbi

fn setup_arguments_on_stack( &self, task: &Task, argv: &[&str], envp: &[&str], initial_sp: usize, ) -> Result<(usize, usize), &'static str>

Setup argc, argv, and envp on the user stack following Unix conventions

Standard Unix stack layout (from high to low addresses):

[high addresses]
envp strings (null-terminated)
argv strings (null-terminated)
envp[] array (null-terminated pointer array)
argv[] array (null-terminated pointer array)
argc (integer)
[low addresses - returned stack pointer]

Arguments

• task - The task to set up arguments for
• argv - Command line arguments
• envp - Environment variables
• initial_sp - Initial stack pointer from setup_user_stack

Returns

Tuple of (new stack pointer, argv array pointer)

fn write_to_stack_memory( &self, task: &Task, vaddr: usize, data: &[u8], ) -> Result<(), &'static str>

Write bytes to stack memory using virtual memory translation

fn write_string_to_stack( &self, task: &Task, vaddr: usize, string: &str, ) -> Result<(), &'static str>

Write a null-terminated string to stack memory

fn normalize_path_to_absolute_scarlet(&self, path_value: &str) -> String

Normalize path string to absolute Scarlet namespace format

This ensures all paths in PATH-like variables are absolute and in the proper Scarlet namespace format.

Trait Implementations

impl AbiModule for ScarletAbi

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 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 get_runtime_config( &self, file_object: &KernelObject, file_path: &str, ) -> Option<RuntimeConfig>

Get userland runtime configuration for executing binaries

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 choose_load_address(&self, elf_type: u16, target: LoadTarget) -> Option<u64>

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

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 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 on_task_exit(&mut self, task: &Task)

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

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

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 get_task_namespace(&self) -> Arc<TaskNamespace>

Get the task namespace for this ABI.

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

Handle conversion when switching ABIs

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

Override interpreter path (for ABI compatibility)

fn get_default_cwd(&self) -> &str

Get default working directory for this ABI

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

Handle incoming event from EventManager

impl Clone for ScarletAbi

fn clone(&self) -> ScarletAbi

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ScarletAbi

fn default() -> Self

Returns the “default value” for a type.

impl Copy for ScarletAbi