Files
bare-operating-system/packages/bare-os-coreutils/man/pages/systemctl.json
T
Raven Scott 13a06ea3e9 feat: ctx 1.37.0, /bin/link, blind-peer proc gate, and CI/docs follow-ups
- Bump bareOsCtxApiVersion to 1.37.0; sync syscalls.example.json and ctx helper
- Add ctx.bareOsReadSnapshotHintsJson mirroring snapshot_hints proc JSON
- Gate blind_relay_router / blind_pairing_sketch / relay_geo_hint behind
  BARE_OS_PROC_BLIND_PEER_RELAY_HINTS; passthrough + env appendix docs
- Add POSIX link(1) via coreutils (link.js, man, commands list, kernel bin)
- Fix JSDoc in verify-runtime-no-incomplete-markers (avoid */ in glob text)
- Align posix-conformance-matrix bareOsSyscallOps with getconf (select, umask)
- Add verify-holepunch-clone-drift.mjs (opt-in pretest), holepunch-drift-repos.json,
  originMainHead in sync-holepunch-clones report
- Tests: warm /bin cache clear, blind proc stub, protomux pool schema 2, glob cap
- Docs: systemctl man, compatibility matrix boot.policy pins, handbook ch.5
  vault/proc note, package-bare-os-booter, kernel-extensions, developer-guide ctx
- CHANGELOG and bare-os-ctx.d.ts updates for subprocess bridge and mirror mounts
2026-04-04 23:19:17 -04:00

63 lines
1.9 KiB
JSON

{
"name": "systemctl",
"section": 1,
"title": "bare-initd service control (systemd-like subset)",
"synopsis": [
"systemctl list|list-units",
"systemctl status [UNIT] [--lines N]",
"systemctl show|cat UNIT",
"systemctl is-failed UNIT",
"systemctl reset-failed [UNIT]",
"systemctl logs UNIT [--lines N]",
"systemctl start|stop|restart UNIT",
"systemctl enable|disable UNIT",
"systemctl is-enabled UNIT",
"systemctl is-active UNIT",
"systemctl help",
"journalctl -u UNIT [--lines N|-n N]"
],
"description": "Lists and manages session-scoped bare-initd units (kernel-logger, bare-cron, …). Implemented by packages/bare-os-booter/lib/systemctl-cli.js (kernel-runner); /bin stubs exist for PATH and man(1). Verbs match --help: show/cat dump unit fields; is-failed; reset-failed (logical no-op on stock initd); enable/disable toggle ~/.config/bare-os/initd/disabled.txt; is-enabled / is-active; logs and status accept --lines. journalctl supports -u, --lines, -n. The legacy name bare-initctl is still accepted as an alias.",
"options": [
{
"flag": "--lines N",
"meaning": "Tail N lines from the unit log (status, logs, journalctl)"
}
],
"aliases": [
"bare-initctl"
],
"keywords": [
"bare-initd",
"initctl",
"service",
"supervisor",
"cron",
"systemd"
],
"bareOsNotes": "journalctl only supports -u UNIT and optional --lines / -n. Unknown systemd verbs are not implemented.",
"seeAlso": [
{
"name": "crontab",
"section": 1
},
{
"name": "bare-os-shell",
"section": 1
}
],
"examples": [
{
"caption": "list units",
"code": "systemctl list-units"
},
{
"caption": "restart scheduler",
"code": "systemctl restart bare-cron"
},
{
"caption": "tail cron errors",
"code": "journalctl -u bare-cron --lines 20"
}
]
}