summaryrefslogtreecommitdiff
path: root/doc/s6-halt.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2016-09-10 13:29:56 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2016-09-10 13:29:56 +0000
commitdfa16e4a89158f3d3198db71e2eba3bda9330078 (patch)
treecfa8399e5348c35eae05f59aa0ea8e2e20bd14ba /doc/s6-halt.html
parentdfc83dd740beaa46b637b87b5a804abf1cff7bee (diff)
downloads6-linux-init-dfa16e4a89158f3d3198db71e2eba3bda9330078.tar.xz
Make s6-linux-init a real init package.
This means: - removing leaky options to s6-linux-init-maker. Default initial_path is now always /usr/bin:/bin; the uid and gid of the catch-all logger (used at boot time) can now be given numerically instead of relying on the (run-time) user db mapping. - moving s6-halt, s6-poweroff and s6-reboot over here, from s6-linux-utils - clarifying on the documentation a bit.
Diffstat (limited to 'doc/s6-halt.html')
-rw-r--r--doc/s6-halt.html55
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/s6-halt.html b/doc/s6-halt.html
new file mode 100644
index 0000000..b6a326c
--- /dev/null
+++ b/doc/s6-halt.html
@@ -0,0 +1,55 @@
+<html>
+ <head>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>s6-linux-init: the s6-halt program</title>
+ <meta name="Description" content="s6-linux-init: the s6-halt program" />
+ <meta name="Keywords" content="s6 linux init administration root utilities shutdown halt poweroff reboot" />
+ <!-- <link rel="stylesheet" type="text/css" href="http://skarnet.org/default.css" /> -->
+ </head>
+<body>
+
+<p>
+<a href="index.html">s6-linux-init</a><br />
+<a href="http://skarnet.org/software/">Software</a><br />
+<a href="http://skarnet.org/">skarnet.org</a>
+</p>
+
+<h1> The <tt>s6-halt</tt> program </h1>
+
+<p>
+<tt>s6-halt</tt> sends a signal to process 1 in order to halt the machine;
+or, with the <tt>-f</tt> option, it performs an immediate hard shutdown.
+</p>
+
+<h2> Interface </h2>
+
+<pre>
+ s6-halt [ -h | -p | -r ] [ -f ]
+</pre>
+
+<ul>
+ <li> s6-halt sends a signal to process 1. </li>
+ <li> It then exits 0. </li>
+</ul>
+
+<h2> Options </h2>
+
+<ul>
+ <li> <tt>-h</tt>&nbsp;: 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. This is the default. </li>
+ <li> <tt>-p</tt>&nbsp;: poweroff. The command will order a power off, which means
+sending a SIGUSR1 to process 1. </li>
+ <li> <tt>-r</tt>&nbsp;: reboot. The command will order a reboot, which means
+sending a SIGINT to process 1. </li>
+ <li> <tt>-f</tt>&nbsp;: 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>