yggdrasil/lib/abi/def/process.abi

// vi:syntax=yggdrasil_abi:

enum Signal(u32) {
    /// Process has tried to perform an illegal memory operation
    MemoryAccessViolation = 1,
    /// Process has hit a breakpoint or was aborted
    Aborted = 2,
    /// Process was killed
    Killed = 3,
    /// Process was interrupted
    Interrupted = 4,
}

newtype ProcessId(u32);
newtype ProcessGroupId(u32);
newtype ThreadId(u32);

// Spawn

/// Controls how processes are created
#[derive(Clone, Debug)]
#[repr(C)]
struct SpawnOptions<'a> {
    /// Creator-relative path to the binary to execute
    pub program: &'a str,
    /// Arguments to the child process
    pub arguments: &'a [&'a str],
    /// Environment for the child process
    pub environment: &'a [&'a str],
    /// Optional arguments to specify details of the creation
    pub optional: &'a [SpawnOption],
}

/// Legacy execve(2) arguments
#[allow(missing_docs)]
#[derive(Clone, Debug)]
#[repr(C)]
struct ExecveOptions<'a> {
    pub program: &'a str,
    pub arguments: &'a [&'a str],
    pub environment: &'a [&'a str],
}

/// Controls how threads are spawned within a process
#[derive(Clone, Debug)]
#[repr(C)]
struct ThreadSpawnOptions {
    /// Thread entry function
    pub entry: extern "C" fn(u64) -> !,
    /// Thread argument value
    pub argument: u64,
    /// Thread stack pointer. NOTE: it's the caller's responsibility to allocate a proper stack for
    /// the thread.
    pub stack_top: usize,
}

// Signal

/// Data provided by the kernel to signal entry function
#[derive(Clone, Debug)]
#[repr(C)]
struct SignalEntryData {
    /// Which signal was issued
    pub signal: Signal,
    /// Saved frame of the context that was interrupted
    pub frame: SavedFrame,
}