Struct SyscallContext 

pub struct SyscallContext { /* private fields */ }

Context passed to safe syscall handlers.

Implementations

impl SyscallContext

pub unsafe fn from_raw(machine: *mut RISCVMachine) -> Option<Self>

Create a syscall context from a raw machine pointer.

Safety

The pointer must be a valid RISCVMachine from libriscv and only used for the duration of the syscall callback.

pub fn registers(&mut self) -> Result<SyscallRegisters<'_>>

Borrow the guest registers for this syscall.

pub fn memview(&mut self, src: u64, len: usize) -> Result<&[u8]>

View guest memory as a read-only slice.

pub fn writable_memview(&mut self, src: u64, len: usize) -> Result<&mut [u8]>

View guest memory as a writable slice.

pub fn memstring(&mut self, src: u64, maxlen: usize) -> Result<&[u8]>

Read a guest NUL-terminated string up to maxlen bytes.

pub fn read(&mut self, src: u64, dst: &mut [u8]) -> Result<()>

Copy guest memory into a host buffer.

pub fn write(&mut self, dst: u64, data: &[u8]) -> Result<()>

Copy host data into guest memory.

pub fn read_pod<T: Pod>(&mut self, src: u64) -> Result<T>

Read a POD value from guest memory.

pub fn write_pod<T: Pod>(&mut self, dst: u64, value: &T) -> Result<()>

Write a POD value into guest memory.

pub fn stop(&mut self)

Stop execution at the next opportunity.

pub fn instruction_counter(&self) -> u64

Return the current instruction counter value.

pub fn max_instruction_counter(&mut self) -> Option<&mut u64>

Borrow the max instruction counter, if available.

pub fn trigger_exception(&mut self, exception: u32, data: u64)

Trigger a CPU exception (only safe during a syscall).

pub fn opaque(&self) -> *mut c_void

Return the opaque userdata pointer.