From 23fba266a9454ee6ca095b7f6eccf523f6526607 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Sat, 2 Mar 2019 09:41:24 +0000 Subject: Save pending changes in 1.0.0.0 branch --- doc/s6-linux-init-shutdownd.html | 81 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 doc/s6-linux-init-shutdownd.html (limited to 'doc/s6-linux-init-shutdownd.html') diff --git a/doc/s6-linux-init-shutdownd.html b/doc/s6-linux-init-shutdownd.html new file mode 100644 index 0000000..b6ea412 --- /dev/null +++ b/doc/s6-linux-init-shutdownd.html @@ -0,0 +1,81 @@ + + + + + + s6-linux-init: the s6-linux-init-shutdownd internal program + + + + + + +

+ +

The `s6-linux-init-shutdownd` internal program

+ +

+s6-linux-init-shutdownd is the daemon that manages the shutdown +procedure for a s6-linux-init installation. It is not meant to be called +directly by the user. +

+ +

Interface

+ +

+     s6-linux-init-shutdownd [ -b bindir ] [ -c basedir ] [ -g gracetime ] fifo
+

+ +

s6-linux-init-shutdownd opens the fifo named pipe +and listens to it. This is where programs such as +s6-linux-init-shutdown send their +commands when they are told to trigger the shutdown procedure.
When it receives a command to shut down, s6-linux-init-shutdownd +first spawns the stage3 script defined by the last +s6-linux-init-maker invocation.
When this script exits, s6-linux-init-shutdownd kills all +processes, first with a SIGTERM, then (after the grace time specified by +the shutdown command) with a SIGKILL.
It then runs the automatically-generated stage 4 script, +which unmounts the file systems and halts, powers off or reboots the +machine.

+ +

Exit codes

+ +

100: wrong usage, or user does not have root privileges.
111: system call failed.

+ +

Options

+ +

-b bindir : look for the +execlineb +script interpreter in the bindir directory. Default is /bin.
-c basedir : look for the +stage3 and stage4 scripts in the basedir +directory. Default is /etc/s6-linux-init.
-g gracetime : if the shutdown command +does not specify a grace time between the SIGTERM and the SIGKILL, use +gracetime milliseconds. Default is 3000.

+ +

Notes

+ +

The s6-linux-init-shutdownd +binary is not meant to be called directly by administrators. It is run +by a s6 service that is automatically +generated by +s6-linux-init-maker.

+ + + -- cgit v1.2.3

The s6-linux-init-shutdownd internal program

Interface

Exit codes

Options

Notes

The `s6-linux-init-shutdownd` internal program