66-hpr.md

title: The 66 Suite: 66-hpr author: Eric Vidal eric@obarun.org

66

obarun.org

66-hpr

Triggers the software shutdown procedure. Performs an immediate hardware shutdown with the ‑f option. It is normally invoked by halt, poweroff or reboot wrappers installed by default at %%skel%%. This program is a modified copy of s6-linux-init-hpr.

Interface

    66-hpr [ -H ] [ -l live ] [ -b banner ] [ -f ] [ -h | -p | -r ] [ -d | -w ] [ -W ]

• If the -f option is passed the system is stopped or rebooted immediately without properly cleaning up.

• Else the machine's shutdown procedure is started.

• The command exits 0; the shutdown procedure happens asynchronously.

This is the traditional sysvinit interface for the halt, poweroff and reboot programs. 66‑hpr must always be called with either ‑h, ‑p or ‑r.

Exit codes

• 0 success
• 100 wrong usage
• 111 system call failed

Options

• -H : prints this help.

• -l live : changes the supervision directory of service to live. By default this will be %%livedir%%. The default can also be changed at compile time by passing the --livedir=live option to ./configure. An existing absolute path is expected and should be within a writable and executable filesystem - likely a RAM filesystem—see 66-scandir.

• -b banner : Text to display before executing the shutdown process. Defaults to:

*** WARNING ***
The system is going down NOW!

• -f : force. The command will not trigger a clean shutdown procedure; it will only sync the filesystems then tell the kernel to immediately halt, poweroff and reboot. This should be the last step in the lifetime cycle of the machine.

• -h : halt. The system will be shut down but the power will remain connected.

• -p : poweroff. Like halt but the power will also be turned off.

• -r : reboot. The system will initialize a warm boot without disconnecting power.

• -d : Do not write a wtmp shutdown entry—see utmp,wtmp and btmp.

• -w : Only write a wtmp shutdown entry; does 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

halt, poweroff and reboot scripts that call 66‑hpr with the relevant option should be copied or symlinked by the administrator into the binary directory of your system.