50 lines
1.6 KiB
Groff
50 lines
1.6 KiB
Groff
.TH INIT 1
|
|
.SH NAME
|
|
init - MontaukOS init system
|
|
|
|
.SH SYNOPSIS
|
|
Spawned automatically by the kernel as PID 0.
|
|
|
|
.SH DESCRIPTION
|
|
init is the first userspace process started by the MontaukOS
|
|
kernel. It discovers system services from 0:/config/init.toml
|
|
and starts them in the order their tables appear in that file.
|
|
|
|
Each enabled service is spawned as a child process. Services may
|
|
run in the background or block startup until they exit. Disabled
|
|
services are logged and skipped.
|
|
|
|
Log output is timestamped and color-coded:
|
|
|
|
HH:MM:SS INFO init Starting dhcp
|
|
HH:MM:SS OK init dhcp finished (pid 1)
|
|
|
|
.SH CONFIGURATION
|
|
Each service is declared as a named TOML table:
|
|
|
|
[services.dhcp]
|
|
path = "0:/os/dhcp.elf"
|
|
enabled = true
|
|
wait = false
|
|
|
|
path is required. name controls the name shown in the boot log and
|
|
defaults to the table name. enabled and wait both default to true.
|
|
optional skips a service whose executable is not installed.
|
|
|
|
fallback names another configured service to start if spawning the
|
|
service fails. A service with fallback_only = true is available as
|
|
a fallback but is not started during the normal pass.
|
|
|
|
After all foreground services exit, init enters an idle loop.
|
|
|
|
.SH LOG LEVELS
|
|
init uses four log levels, each with a distinct color:
|
|
|
|
OK Green Service completed successfully
|
|
INFO Cyan Informational (service starting, etc.)
|
|
WARN Yellow Non-fatal warning
|
|
FAIL Red Service failed to start
|
|
|
|
.SH SEE ALSO
|
|
dhcp(1), shell(1), syscalls(2)
|