Struct Registers 

#[repr(C)]
pub struct Registers {
    pub gprs: GeneralPurposeRegisters,
    error_code: u64,
    /* private fields */
}

x86_64 Trap frame.

Fields

gprs: GeneralPurposeRegisters

error_code: u64

Implementations

impl Registers

pub fn new() -> Self

Creates a new register frame for a user thread.

This function initializes a Registers structure with default values for a new user-space thread.

Returns

• A Registers instance with default values for user-space execution.

Example

let mut regs = Registers::new();
*regs.rip() = 0x400000; // Set entry point
*regs.rsp() = 0x7FFFFFFFE000; // Set user stack pointer

pub fn rip(&mut self) -> &mut usize

Returns a mutable reference to the instruction pointer (RIP).

This function allows modifying the instruction pointer, which determines the next instruction the CPU will execute when the thread resumes.

Returns

• A mutable reference to the rip field in the interrupt stack frame.

Example

let mut regs = Registers::new();
*regs.rip() = 0x400000; // Set the entry point

pub fn rsp(&mut self) -> &mut usize

Returns a mutable reference to the stack pointer (RSP).

This function allows modifying the stack pointer, which should point to the top of the stack before execution.

Returns

• A mutable reference to the rsp field.

Example

let mut regs = Registers::new();
*regs.rsp() = 0x7FFFFFFFE000; // Set the user stack pointer

pub extern "C" fn launch(&self) -> !

Launch the frame.

Launches a thread by restoring its saved register state.

This function returns the never type (!), meaning that once executed, there is no way to return to the current execution context.

Safety

• The kernel must release all temporary resources such as locally allocated Box, [SpinLockGuard], or [InterruptGuard] before calling this function.

Behavior

1. Restores general-purpose registers from self.gprs.
2. Enables interrupts.
3. Transfers to saved execution state by executing iretq.

Example Usage

let regs = Registers::new();
regs.launch(); // This function does not return
unreachable!() // Execution will never reach here

Trait Implementations

impl Clone for Registers

fn clone(&self) -> Registers

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Registers

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Registers

fn default() -> Self

Returns the “default value” for a type.

impl Copy for Registers