SchOS/etc/schinit
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nexoniarz a1c965da1e include: one folder per subsystem, and includes that name it
Sixty-five headers sat side by side in include/, so `#include "irq.h"`
said nothing about where irq.h was or what it belonged to, and errno.h,
stat.h and fcntl.h at the top shadowed the system's for any host tool
built with -I./include. They are in folders now -- arch/ core/ fs/
dev/ gfx/ net/ uapi/ (and ldls/ for the Linux driver layer) -- and
every include names the folder, as Linux's do: "core/proc.h".

Done mechanically and checked the hard way: the kernel built from this
tree disassembles identically to the one built from the tree before
it. The full image boots, and userland is the same set of programs.
Paths in docs and comments follow; docs/guides/layout.md has a table
of what is where, and tools/fix-includes.py rewrites old-style
includes from the folders in the tree, for code written before this.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S1giNvrHTrPMPw7V6x1kQ4
2026-10-23 15:05:12 +02:00
..
console-shell.job tty: six virtual terminals, and the plumbing that makes them terminals 2026-09-13 00:08:00 +02:00
keymap.job kbd: three layouts, and the arrow keys were sitting on top of UTF-8 2026-09-20 01:09:32 +02:00
README hybrid: the driver is killed, and the driver comes back 2026-09-14 00:05:43 +02:00
resolvconf.job userland: 268 applets, an editor, names that resolve, and a web server 2026-09-14 19:24:55 +02:00
schdbgd.job include: one folder per subsystem, and includes that name it 2026-10-23 15:05:12 +02:00
tty2-shell.job tty: six virtual terminals, and the plumbing that makes them terminals 2026-09-13 00:08:00 +02:00
tty3-shell.job include: one folder per subsystem, and includes that name it 2026-10-23 15:05:12 +02:00
tty4-shell.job include: one folder per subsystem, and includes that name it 2026-10-23 15:05:12 +02:00
tty5-shell.job include: one folder per subsystem, and includes that name it 2026-10-23 15:05:12 +02:00
tty6-shell.job include: one folder per subsystem, and includes that name it 2026-10-23 15:05:12 +02:00
vgpud.job hybrid: the driver is killed, and the driver comes back 2026-09-14 00:05:43 +02:00

Job manifests for schinit, SchOS process 1.

Every *.job file in this directory is loaded at boot. Format is sectioned
key = value; # starts a comment, keys are case-insensitive.

  Label             a reverse-DNS name, as launchd uses. Identity, not a path.
  Program           the binary to execute
  Args              argv, space separated. argv[0] is conventionally the
                    basename, so `Args = sh` for `/bin/sh`.
  RunAtLoad         start it when schinit loads
  KeepAlive         restart it when it exits
  Disabled          load it but do not start it
  ThrottleInterval  seconds between respawns (default 1)
  StandardIn        \
  StandardOut        > paths to open as fd 0, 1, 2
  StandardError     /

  [Socket <name>]
  Path              a unix socket schinit will hold on the job's behalf and
                    start the job on first connect

A KeepAlive job that exits with status 78 (sysexits.h's EX_CONFIG) is not
restarted, and schinit says which job stopped and that it stopped on purpose.
This is for a program that has looked at the machine and found nothing here it
can run against -- a driver whose device is absent, say -- which would otherwise
report the same thing every ThrottleInterval for the rest of the uptime. A job
that was killed or crashed carries a signal in its status, never matches, and
comes back exactly as KeepAlive promises.

Socket sections are parsed but not yet acted on -- that is milestone 2, and
demand launching is the whole reason this is shaped after launchd rather than
sysvinit. The key exists now so manifests do not have to change later.

Unknown keys and unknown sections are ignored rather than fatal: a manifest
written for a newer schinit must not stop this one booting the machine.