From 5e95d487982b9362b544139b98d1da55fa6ef78c Mon Sep 17 00:00:00 2001 From: PS Date: Sat, 7 Feb 2026 10:20:30 +0100 Subject: Add doc --- doc/bin/system-shutdown-daemon.html | 123 ++++++++++++++++++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 doc/bin/system-shutdown-daemon.html (limited to 'doc/bin/system-shutdown-daemon.html') diff --git a/doc/bin/system-shutdown-daemon.html b/doc/bin/system-shutdown-daemon.html new file mode 100644 index 0000000..82493b6 --- /dev/null +++ b/doc/bin/system-shutdown-daemon.html @@ -0,0 +1,123 @@ + + + + + + + system-shutdown-daemon + + + +

+ goetia-base +
+ goetia +
+ Software +
+ 0x53.net +

+ +

The system-shutdown-daemon program

+ system-shutdown-daemon contains the Kernel independent + part of the shutdown sequence. + It is invoked by the Kernel specifict goetia-shutdown service, + e.g. + goetia-shutdown service for Linux + or + goetia-shutdown service for FreeBSD. + system-shutdown-daemon is a long lived program that waits for instruction by the system-shutdown command + The latter is part of the Kernel specific packages, e.g. + goetia-linux + or + goetia-freebsd. +

Interface

     system-shutdown-daemon

+ system-shutdown-daemon takes no arguments. +
+ It tries to execute ./stage3b, + which is by default not executable. + If it can not execute ./stage3b, + and only in this case, + it continues with the following. +
+ All services managed by + s6-rc + are stopped. + This means, all services defined in + source directories + at the src subdirectory of the + system configuration directory. +
+ Next, all leftover services except + s6-svscan-log, goetia-shutdown and goetia-rescue, are stopped. +
+ The file stage3b, expected to exist in the current working directory + is made executable. + This file is part of the Kernel secific service directories. + (see e.g. goetia-shutdown) +
+ all uncaught system logs are copied from the + log/uncaught-logs + subdirectory of the + system runtime directory. + to the + uncaught-logs + subdirectory of the + system log directory. +
+ SIGTERM is sent to all processes but PID 1. +
+ This also stops the system-shutdown-daemon process. + It is automatically restarted by the system supervision tree, + but this time, the file ./stage3b is executable + and executed instead of what is described above. + What happens in ./stage3b is Kernel specific, + and documented on + goetia-shutdown service for Linux, + goetia-shutdown service for FreeBSD, + etc. +

Exit codes

+ Since system-shutdown-daemon is an + execline + script, it exits with an approximation + of employed program that failed. +
+ system-shutdown-daemon mostly uses + execline + and + s6 + software, the exit behaviour of which can be looked up on + their respective pages. +
+ See also: + execline exit code handling. +

Options

+ There are no options to system-shutdown-daemon. +

+ + -- cgit v1.2.3