How crickertech/nife works
nife is a capability-based Rust microkernel OS. Its principal workflow is booting into the kernel, entering userspace, and having a userspace progenitor construct processes and services; users then interact through a capability shell whose grant logic makes resource designation authorization. Kernel memory, scheduling, capabilities, and revocation underpin that workflow. The README documents the product capabilities; the source excerpts and index show selected kernel relationships, so unsampled service wiring is not expanded into speculative call chains.
Main entry points: user.rs User process runtime · main.rs Kernel entry · sched.rs Scheduler · memory_region.rs Memory regions
Components 25
Boot and execution
- UEFI loader
uefi_loader/src/main.rs - Kernel entry
kernel/src/main.rs
Kernel core
- Architecture layer
kernel/src/arch/mod.rs - Scheduler
kernel/src/sched.rs - Thread runtime
kernel/src/thread.rs - Physical memory
kernel/src/memory.rs - Kernel console
kernel/src/console.rs - Machine statistics
kernel/src/machine_statistics.rs - Floating-point state
kernel/src/fp.rs - Kernel synchronization
kernel/src/sync.rs - Kernel stacks
kernel/src/stack.rs - Progenitor stack
kernel/src/progenitor_stack.rs - Kernel test support
kernel/src/testing.rs
Capabilities and processes
- Capability objects
kernel/src/cap.rs - Memory regions
kernel/src/memory_region.rs - User process runtime
kernel/src/user.rs - Object revocation
kernel/src/revoke.rs - Grant planning
crates/grant_plan/src/lib.rs
Userspace services
- Userspace progenitor
crates/system_initializer/src/lib.rs - Capability shell
components/src/swish.rs - Filesystem service
kernel/src/user/fs_service.rs - Network time client
components/src/network_time_client.rs - Display and compositor
kernel/src/user/display_service.rs
Other components
- Platform firmware
- System user
Connections 18
- Platform firmware → UEFI loader: starts boot
- UEFI loader → Kernel entry: hands off
- Kernel entry → Architecture layer: selects hardware
- Kernel entry → Scheduler: starts kernel
- Scheduler → Thread runtime: schedules
kernel/src/sched.rs - Scheduler → Capability objects: uses objects
kernel/src/sched.rs - User process runtime → Physical memory: maps processes
kernel/src/user.rs - User process runtime → Memory regions: manages spaces
kernel/src/user.rs - User process runtime → Object revocation: tears down
kernel/src/user.rs - Memory regions → Physical memory: allocates frames
kernel/src/memory_region.rs - Memory regions → Object revocation: supports revocation
kernel/src/memory_region.rs - Userspace progenitor → User process runtime: builds processes
README.md - System user → Capability shell: enters commands
README.md - Capability shell → Grant planning: plans grants
crates/grant_plan/src/lib.rs - Userspace progenitor → Filesystem service: builds services
README.md - User process runtime → Network time client: hosts service
README.md - User process runtime → Display and compositor: hosts service
README.md - User process runtime → Kernel console: provides diagnostics
README.md