diff options
Diffstat (limited to 'doc/s6-poweroff.html')
| -rw-r--r-- | doc/s6-poweroff.html | 37 |
1 files changed, 26 insertions, 11 deletions
diff --git a/doc/s6-poweroff.html b/doc/s6-poweroff.html index 13af3e5..5b0a4fc 100644 --- a/doc/s6-poweroff.html +++ b/doc/s6-poweroff.html @@ -5,7 +5,7 @@ <meta http-equiv="Content-Language" content="en" /> <title>s6-linux-utils: the s6-poweroff program</title> <meta name="Description" content="s6-linux-utils: the s6-poweroff program" /> - <meta name="Keywords" content="s6 linux administration root poweroff system halt power off" /> + <meta name="Keywords" content="s6 linux administration root utilities shutdown halt poweroff reboot" /> <!-- <link rel="stylesheet" type="text/css" href="http://skarnet.org/default.css" /> --> </head> <body> @@ -19,22 +19,37 @@ <h1> The <tt>s6-poweroff</tt> program </h1> <p> -<tt>s6-poweroff</tt> syncs the filesystems and halts the machine -immediately, switching the power off if possible. -</p> - -<p> - This is different from the sysvinit <tt>poweroff</tt> -command, which performs <tt>shutdown</tt>. The -s6-linux-utils <tt>s6-poweroff</tt> command is more or less equivalent to -sysvinit's <tt>poweroff -f</tt>. +<tt>s6-poweroff</tt> sends a signal to process 1 in order to power off the machine; +or, with the <tt>-f</tt> option, it performs an immediate hard shutdown. </p> <h2> Interface </h2> <pre> - s6-poweroff + s6-poweroff [ -h | -p | -r ] [ -f ] </pre> +<ul> + <li> s6-poweroff sends a signal to process 1. </li> + <li> It then exits 0. </li> +</ul> + +<h2> Options </h2> + +<ul> + <li> <tt>-h</tt> : halt. The command will order a halt (i.e. the system will +be shut down, but the power will remain up), which means +sending a SIGUSR2 to process 1. </li> + <li> <tt>-p</tt> : poweroff. The command will order a power off, which means +sending a SIGUSR1 to process 1. This is the default. </li> + <li> <tt>-r</tt> : reboot. The command will order a reboot, which means +sending a SIGINT to process 1. </li> + <li> <tt>-f</tt> : force. The command will not send any signal to process 1; +it will just sync the filesystems then tell the kernel to halt, poweroff or reboot. +<tt>s6-reboot -f</tt> or <tt>s6-poweroff -f</tt> should be the last program +executed in the lifetime of a machine, at the end of the shutdown script called +by process 1 when it receives a signal telling it to shut down. </li> +</ul> + </body> </html> |