Struct UserContext

#[repr(C)]
pub struct UserContext {
    pub general: GeneralRegs,
    pub trap_num: usize,
    pub error_code: usize,
}

User space context.

Fields

general: GeneralRegs

trap_num: usize

error_code: usize

Implementations

impl UserContext

pub fn run(&mut self)

Go to user space with the context, and come back when a trap occurs.

On return, the context will be reset to the status before the trap. Trap reason and error code will be placed at trap_num and error_code.

If the trap was triggered by syscall instruction, the trap_num will be set to 0x100.

If trap_num is 0x100, it will go user by sysret (rcx and r11 are dropped), otherwise it will use iret.

Example

use trapframe::{UserContext, GeneralRegs};

// init user space context
let mut context = UserContext {
    general: GeneralRegs {
        rip: 0x1000,
        rsp: 0x10000,
        ..Default::default()
    },
    ..Default::default()
};
// go to user
context.run();
// back from user
println!("back from user: {:#x?}", context);

impl UserContext

pub fn get_syscall_num(&self) -> usize

Get number of syscall.

pub fn get_syscall_ret(&self) -> usize

Get return value of syscall.

pub fn set_syscall_ret(&mut self, ret: usize)

Set return value of syscall.

pub fn get_syscall_args(&self) -> [usize; 6]

Get syscall args.

pub fn set_ip(&mut self, ip: usize)

Set instruction pointer.

pub fn set_sp(&mut self, sp: usize)

Set stack pointer.

pub fn get_sp(&self) -> usize

Get stack pointer.

pub fn set_tls(&mut self, tls: usize)

Set thread-local storage pointer.

Trait Implementations

impl Clone for UserContext

fn clone(&self) -> UserContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UserContext

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

Formats the value using the given formatter.

impl Default for UserContext

fn default() -> UserContext

Returns the “default value” for a type.

impl PartialEq for UserContext

fn eq(&self, other: &UserContext) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for UserContext

impl Eq for UserContext

impl StructuralPartialEq for UserContext