JMR-dev
cb48a676e9
Ports the community s6/s6-rc service catalog (early-boot mounts, udev,
dbus, session/power, networking, display managers, peripheral daemons)
to Lua-based service definitions.
- src/lua/s6lua.lua: shared helper library (exec, logging, fstab
parsing, oneshot shell runner, readiness notification)
- src/native/s6exec.c: minimal execvp() binding so longrun `run`
scripts can replace their own process image with the real daemon,
since stock Lua has no exec() and os.execute("exec ...") does not
solve it (the interpreter stays alive as an unsupervised parent)
- tools/catalog.lua + gen-services.lua: table-driven generator for
the structurally identical -srv/-log daemon pairs and agetty ttys
- tools/lint.lua, check-syntax.ps1, set-exec-bits.ps1: local
verification (no live s6/Linux target available this session)
- services/: 50 service directories (14 early-boot oneshots, 12
daemon srv/log pairs, 6 agetty ttys, boot/mount/setup/ttys/
graphical/default bundles)
Authored and syntax/structurally validated only. Native module is
unbuilt and daemon flags are unverified against Artix's real catalog
(gitea was unreachable during research) -- see docs/CONVENTIONS.md.
2.2 KiB
s6-lua
A port of the community s6/s6-rc service catalog (the kind Artix Linux/Obarun use in place of systemd units) into Lua-based service definitions.
Stock Lua has no exec() binding, and os.execute("exec daemon") doesn't solve the problem
either — it forks a shell that execs, but the Lua process itself stays alive blocked in
waitpid(), so s6 ends up supervising the interpreter instead of the daemon. longrun services
here hand off to the real daemon through a tiny vendored C module (src/native/s6exec.c,
execvp()); oneshot and finish scripts don't need it since they run to completion rather than
persisting. See docs/CONVENTIONS.md for the full rationale and naming rules.
Layout
services/ the s6-rc source-definition tree (deploys verbatim to /etc/s6/sv)
src/lua/ shared helper library (s6lua.lua) every service script requires
src/native/ native exec binding (s6exec.c) + Makefile, Linux-only build
tools/ generator, structural linter, syntax checker, exec-bit fixer, installer
docs/ conventions and naming rules
services/default is the top-level bundle (boots to graphical target with SDDM); services/boot
is the multi-user/console-only target.
Status
Authored and syntax-checked only — there is no live s6/s6-rc install in this environment to boot-
test against. See docs/CONVENTIONS.md for known unverified gaps (daemon flags reconstructed from
convention, not confirmed against Artix's actual catalog) and the recommended next step (install
s6/s6-rc/s6-linux-init on a Linux host — Arch is the closest packaging match — and boot-test the
boot bundle before enabling graphical).
Local tooling
Requires lua55/luac55 (this repo was authored against Lua 5.5, written to a subset valid under
5.4 too — see docs/CONVENTIONS.md).
lua55 tools/gen-services.lua # regenerate the -srv/-log pairs + agetty ttys from tools/catalog.lua
lua55 tools/lint.lua # structural validation of services/
tools/check-syntax.ps1 # luac55 -p over every script
tools/set-exec-bits.ps1 # fix the git executable bit before committing (Windows checkout)
tools/install.sh deploys everything to a real Linux target (untested this session).