From 1bfba3b0be32306b078f5ee527b864e758b2c77b Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Fri, 26 Apr 2019 15:52:54 +0000 Subject: Make a single hpr. Full doc, first draft. --- doc/s6-linux-init-hpr.html | 87 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 doc/s6-linux-init-hpr.html (limited to 'doc/s6-linux-init-hpr.html') diff --git a/doc/s6-linux-init-hpr.html b/doc/s6-linux-init-hpr.html new file mode 100644 index 0000000..304ed35 --- /dev/null +++ b/doc/s6-linux-init-hpr.html @@ -0,0 +1,87 @@ + + + + + + s6-linux-init: the s6-linux-init-hpr program + + + + + + +

+ +

The `s6-linux-init-hpr` program

+ + +

+ s6-linux-init-hpr triggers the software shutdown procedure, +or, with the -f option, it perform an immediate hardware shutdown. +It is normally invoked as /sbin/halt, /sbin/poweroff or +/sbin/reboot. +

+ +

Interface

+ +

+     s6-linux-init-hpr [ -f ] [ -h | -p | -r ] [ -d | -w ] [ -W ]
+

+ +

If the -f option is present, the hardware command is executed immediately.
Else, the machine's shutdown procedure is started. +
The command exits 0; the shutdown procedure happens asynchronously.

+ +

+ This interface is the traditional sysvinit interface for the +halt, poweroff and reboot programs. +s6-linux-init-hpr must always be called with one of the +-h, -p or -r options. +

+ +

Exit codes

+ +

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

+ +

Options

+ +

-f : force. The command will not trigger a clean shutdown +procedure; it will just sync the filesystems then tell the kernel to immediately +halt, poweroff or reboot. This should be the last step in the lifetime of the +machine.
-h : halt. The system will be shut down, but the power will remain up.
-p : poweroff. The system will be shut down and the power turned off.
-r : reboot. The system will reboot.
-d : Do not write a wtmp shutdown entry.
-w : Only write a wtmp shutdown entry; do not actually shut down +the system.
-W : Do not send a wall message to users before shutting +down the system. Some other implementations of the halt, poweroff +and reboot commands use the --no-wall long option to achieve this.

+ +

Notes

+ +

When an administrator runs +s6-linux-init-maker, the resulting +directory has a bin/ subdirectory that contains halt, +poweroff and reboot scripts that call s6-linux-init-hpr +with the relevant option. The +contents of this bin/ subdirectory should then be copied by the +administrator into /sbin for full interface compatibility with sysvinit.

+ + + -- cgit v1.3.1

The s6-linux-init-hpr program

Interface

Exit codes

Options

Notes

The `s6-linux-init-hpr` program