Struct ScarletAbi

pub struct ScarletAbi;

Implementations

impl ScarletAbi

fn setup_arguments_on_stack( &self, task: &mut 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: &mut Task, vaddr: usize, data: &[u8], ) -> Result<(), &'static str>

Write bytes to stack memory using virtual memory translation

fn write_string_to_stack( &self, task: &mut 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>

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>, ) -> 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: &mut Task, trapframe: &mut Trapframe, ) -> Result<(), &'static str>

Binary execution (each ABI supports its own binary format)

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 initialize_from_existing_handles( &self, _task: &mut Task, ) -> Result<(), &'static str>

Handle conversion when switching ABIs

fn get_default_cwd(&self) -> &str

Get default working directory for this ABI

impl Clone for ScarletAbi

fn clone(&self) -> ScarletAbi

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for ScarletAbi

fn default() -> ScarletAbi

Returns the “default value” for a type.

impl Copy for ScarletAbi