Files
bare-operating-system/docs/architecture/kernel-subsystems.md
T
2026-04-25 23:04:56 -04:00

3.1 KiB

Kernel subsystem map (booter + guest image)

This document is the boundary map for the Bare operating system runtime: which responsibilities live in which layer, and which modules are the canonical entry points.

Subsystems

Subsystem Role Canonical modules
boot Swarm join, MBR, Hyperdrive replication, timeout, offline LKG packages/bare-os-booter/index.js, bare-os-kernel-loader.js, bare-os-lifecycle-manager.js
vfs Two-drive routing, pseudo /proc//sys//run//dev, policy; optional **$HOME/.www/mnt/www** when HDMS label www is mounted vfs.js, vfs-posix-meta.js
initd services Stock bare-initd units (logger, static ~/.www, Holesail, cron, SSH, …) bare-initd.js, bare-os-www-initd.js, bare-holesail.js, bare-cron.js, bare-openssh.js
process Synthetic process table, jobs/shell coordination bare-os-process-table.js, shell.js
ipc FIFOs, JSON-RPC, fan-out bare-os-ipc.js
net Hyperswarm, Protomux, peer disk I/O swarm-disk.js, bare-os-swarm-connection-manager.js
security Identity, vault, ACL evaluation, audit chain identity-session.js, identity-account.js, bare-os-acl-eval.js, bare-os-audit-chain.js
capabilities Stock kernel capability words, seed strict matrix bare-os-capability-registry.js, bare-os-protocol

Guest image (kernel/)

Stage Source
Boot policy, rc, extensions kernel/init.js
Stock /bin packages/bare-os-coreutils (seeded into image)