Module os::trap

Trap handling functionality

For rCore, we have a single trap entry point, namely __alltraps. At initialization in init(), we set the stvec CSR to point to it.

All traps go through __alltraps, which is defined in trap.S. The assembly language code does just enough work restore the kernel space context, ensuring that Rust code safely runs, and transfers control to trap_handler().

It then calls different functionality based on what exactly the exception was. For example, timer interrupts trigger task preemption, and syscalls go to syscall().

Modules

• context 🔒
  Implementation of TrapContext

Structs

• TrapContext
  trap context structure containing sstatus, sepc and registers

Functions

• enable_timer_interrupt
  enable timer interrupt in supervisor mode
• init
  Initialize trap handling
• set_kernel_trap_entry 🔒
  set trap entry for traps happen in kernel(supervisor) mode
• set_user_trap_entry 🔒
  set trap entry for traps happen in user mode
• trap_from_kernel
  handle trap from kernel
• trap_handler
  trap handler
• trap_return
  return to user space