
GuardBSD
Rust Multi-Microkernel OS • Capability Security • Production-Ready
GuardBSD Documentation
Architecture, API, and Building
System architecture, IPC/API reference pointers, requirements, and build steps.
Architecture
┌────────────────────────────────────────────┐
│ User Applications │
├────────────────────────────────────────────┤
│ gsh │ zfs │ mkfs.guardfs │ top │
├────────────────────────────────────────────┤
│ VFS │ GuardFS │ GuardZFS │ Init │ NetD │
├────────────────────────────────────────────┤
│ µK-Space │ µK-Time │ µK-IPC │
├────────────────────────────────────────────┤
│ System Call Layer │
├────────────────────────────────────────────┤
│ GuaBoot │
└────────────────────────────────────────────┘API Reference
Full API — docs/api/REFERENCE.md
Examples
// IPC
let port = port_create()?;
ipc_send(port, &Message::new(1, b"ping"))?;
// Files
let fd = open("/data", O_RDWR)?;
write(fd, b"GuardBSD")?;
close(fd)?;
// Memory
let paddr = pmm_alloc()?;
vmm_map(0x100000, paddr, READ | WRITE)?;System Requirements
| Minimum | Recommended | |
|---|---|---|
| CPU | x86_64 | dual-core |
| RAM | 256 MB | 2 GB |
| Disk | 1 GB | 4 GB+ |
| Boot | UEFI/BIOS | UEFI |
Building
# Ubuntu
sudo apt install build-essential rustc cargo qemu-system-x86 xorriso gnu-efi nasm
rustup target add x86_64-unknown-none
make iso
make test-boot