Struct UserContext 

pub struct UserContext(/* private fields */);

Available on crate feature uspace only.

Context to enter user space.

Implementations

impl UserContext

pub fn new(entry: usize, ustack_top: VirtAddr, arg0: usize) -> Self

Creates a new context with the given entry point, user stack pointer, and the argument.

pub fn prepare_clone_child_return_state(&mut self)

Normalizes a cloned user context so it can safely return to user mode.

pub fn run(&mut self) -> ReturnReason

Enter user space.

It restores the user registers and jumps to the user entry point (saved in sepc).

This function returns when an exception or syscall occurs.

Methods from Deref<Target = TrapFrame>

pub fn arg0(&self) -> usize

Gets the 0th syscall argument.

pub fn set_arg0(&mut self, a0: usize)

Sets the 0th syscall argument.

pub fn arg1(&self) -> usize

Gets the 1st syscall argument.

pub fn set_arg1(&mut self, a1: usize)

Sets the 1st syscall argument.

pub fn arg2(&self) -> usize

Gets the 2nd syscall argument.

pub fn set_arg2(&mut self, a2: usize)

Sets the 2nd syscall argument.

pub fn arg3(&self) -> usize

Gets the 3rd syscall argument.

pub fn set_arg3(&mut self, a3: usize)

Sets the 3rd syscall argument.

pub fn arg4(&self) -> usize

Gets the 4th syscall argument.

pub fn set_arg4(&mut self, a4: usize)

Sets the 4th syscall argument.

pub fn arg5(&self) -> usize

Gets the 5th syscall argument.

pub fn set_arg5(&mut self, a5: usize)

Sets the 5th syscall argument.

pub fn sysno(&self) -> usize

Get the syscall number.

pub fn set_sysno(&mut self, a7: usize)

Sets the syscall number.

pub fn ip(&self) -> usize

Gets the instruction pointer.

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

Sets the instruction pointer.

pub fn sp(&self) -> usize

Gets the stack pointer.

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

Sets the stack pointer.

pub fn retval(&self) -> usize

Gets the return value register.

pub fn set_retval(&mut self, a0: usize)

Sets the return value register.

pub fn set_ra(&mut self, ra: usize)

Sets the return address.

pub fn tls(&self) -> usize

Gets the TLS area.

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

Sets the TLS area.

pub fn backtrace(&self) -> Backtrace

Unwind the stack and get the backtrace.

pub unsafe fn emulate_unaligned(&mut self) -> Result<(), UnalignedError>

Emulates an unaligned memory access triggered by a trap.

Safety

This function uses raw pointers and inline assembly to handle unaligned memory accesses, so it must only be called in a valid trap context with a properly initialized TrapFrame.

Trait Implementations

impl Clone for UserContext

fn clone(&self) -> UserContext

Returns a duplicate 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 Deref for UserContext

type Target = TrapFrame

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for UserContext

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Copy for UserContext