How bouezleonardo/polvoss-kernel works
This is a small RISC-V kernel implementing boot, virtual memory, process execution and scheduling, traps/syscalls, and console/device I/O. The principal workflow initializes machine state and memory, starts an initial ELF process, schedules it, then handles user traps and system calls before returning to execution. The graph preserves the major runtime stages and supporting synchronization and architecture layers. README content is absent; some subsystem links are based on source-index references rather than inspected call sites, so those are marked unverified.
Main entry points: processing.rs Process management · start.rs Boot initialization · virtual_memory.rs Virtual memory · trap_handlers.rs Trap handling
Components 28
Boot
- Kernel entry
src/main.rs - Boot initialization
src/boot/start.rs - Machine setup
src/boot/hard_config.rs - System constants
src/config/constants.rs
Memory
- Frame allocator
src/memory/frame_alloc.rs - Physical layout
src/memory/memory_layout.rs - Virtual memory
src/memory/virtual_memory.rs - Address and page tables
src/riscv/memory_types.rs
Processes
- ELF loader
src/file/elf.rs - Process loader
src/proc/loader.rs - Process state
src/proc/control_types.rs - Process management
src/proc/processing.rs - Scheduler
src/proc/scheduler.rs - Round-robin policy
src/proc/round_robin.rs - Process synchronization
src/proc/sync.rs - Spin mutex
src/proc/spin.rs
Traps and syscalls
- Trap handling
src/trap/trap_handlers.rs - User trap vector
src/trap/uservec.rs - Syscall dispatch
src/trap/syscall_handler.rs - Process syscalls
src/trap/syscall_proc.rs - File syscalls
src/trap/syscall_file.rs - Interrupt controller
src/trap/plic.rs
Platform I/O and RISC-V
- Console
src/io/console.rs - UART
src/io/uart.rs - Display monitor
src/io/monitor.rs - Supervisor controls
src/riscv/supervisor_mode.rs
Other components
- User process
- RISC-V hardware
Connections 40
- Kernel entry → Boot initialization: starts
src/main.rs - Boot initialization → Machine setup: configures
src/boot/start.rs - Boot initialization → Frame allocator: initializes
src/boot/start.rs - Boot initialization → Virtual memory: initializes
src/boot/start.rs - Boot initialization → Process management: starts
src/boot/start.rs - Boot initialization → Scheduler: starts
src/boot/start.rs - Boot initialization → Trap handling: installs
src/boot/start.rs - Machine setup → Supervisor controls: configures
src/boot/hard_config.rs - Frame allocator → Physical layout: bounds allocation
src/memory/frame_alloc.rs - Frame allocator → Spin mutex: locks allocator
src/memory/frame_alloc.rs - Virtual memory → Frame allocator: allocates frames
src/memory/virtual_memory.rs - Virtual memory → Physical layout: maps layout
src/memory/virtual_memory.rs - Virtual memory → Address and page tables: uses page tables
src/memory/virtual_memory.rs - Virtual memory → Process state: updates address space
src/memory/virtual_memory.rs - Process loader → ELF loader: loads image
src/proc/loader.rs - Process loader → Virtual memory: maps process
src/proc/loader.rs - Process loader → Process state: sets process state
src/proc/loader.rs - Process management → Process loader: loads init process
src/proc/processing.rs - Process management → Virtual memory: creates process image
src/proc/processing.rs - Process management → Process state: manages PCB
src/proc/processing.rs - Scheduler → Process management: switches processes
src/proc/scheduler.rs - Scheduler → Round-robin policy: selects process
src/proc/scheduler.rs - Process management → Spin mutex: uses locks
src/proc/processing.rs - Process synchronization → Process management: schedules waiters
src/proc/sync.rs - Process synchronization → Spin mutex: protects queues
src/proc/sync.rs - User process → User trap vector: traps into
- User trap vector → Trap handling: dispatches trap
src/trap/uservec.rs - Trap handling → Syscall dispatch: dispatches syscall
src/trap/trap_handlers.rs - Syscall dispatch → Process syscalls: dispatches process calls
src/trap/syscall_handler.rs - Syscall dispatch → File syscalls: dispatches file calls
src/trap/syscall_handler.rs - Process syscalls → Process management: operates on processes
src/trap/syscall_proc.rs - Trap handling → Interrupt controller: handles device interrupts
src/trap/trap_handlers.rs - Trap handling → Supervisor controls: reads trap state
src/trap/trap_handlers.rs - Boot initialization → Console: initializes
src/boot/start.rs - Console → Display monitor: writes display
src/io/console.rs - Console → UART: uses serial I/O
src/io/console.rs - Console → Process management: copies user data
src/io/console.rs - Interrupt controller → Process management: signals device event
src/trap/plic.rs - RISC-V hardware → Interrupt controller: raises interrupts
- RISC-V hardware → UART: provides device I/O