GuardBSD Logo

GuardBSD

Rust Multi-Microkernel OS • Capability Security • Production-Ready

licensebuildreleaseplatformfosdem

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

MinimumRecommended
CPUx86_64dual-core
RAM256 MB2 GB
Disk1 GB4 GB+
BootUEFI/BIOSUEFI

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
PreviousPage 3 of 4Next
GuardBSD Documentation - Winter Saga