diff options
| author | Laurent Bercot <ska-skaware@skarnet.org> | 2026-01-13 04:16:54 +0000 |
|---|---|---|
| committer | Laurent Bercot <ska-skaware@skarnet.org> | 2026-01-13 04:16:54 +0000 |
| commit | 625252d2e88c9a6cb84ecb8731c14d85dd699aa9 (patch) | |
| tree | 9d40d9a83d5fe3b0699b5974b6515349319c8464 /doc/s6_system.html | |
| parent | 12868f261b1e822ae7f132216c2a5a380a163102 (diff) | |
| download | s6-frontend-625252d2e88c9a6cb84ecb8731c14d85dd699aa9.tar.gz | |
Better live_status and live_stop_everything, more doc
Diffstat (limited to 'doc/s6_system.html')
| -rw-r--r-- | doc/s6_system.html | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/doc/s6_system.html b/doc/s6_system.html new file mode 100644 index 0000000..10d52d7 --- /dev/null +++ b/doc/s6_system.html @@ -0,0 +1,147 @@ +<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-frontend: the s6 system command</title> + <meta name="Description" content="s6-frontend: the s6 system command" /> + <meta name="Keywords" content="s6 ecosystem supervision service manager user interface init skarnet.org skarnet software boot shutdown system reboot poweroff" /> + <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> --> + </head> +<body> + +<p> +<a href="s6.html">The s6 command</a><br /> +<a href="index.html">s6-frontend</a><br /> +<a href="//skarnet.org/software/">Software</a><br /> +<a href="//skarnet.org/">skarnet.org</a> +</p> + +<h1> The <tt>s6 system</tt> command </h1> + +<p> + <tt>s6 system</tt> regroups actions related to booting or shutting down +the system. +</p> + +<div id="interface"> +<h2> Interface </h2> +</div> + +<pre> + s6 system <em>subcommand</em> +</pre> + +<ul> + <li> No subcommand takes any options. </li> +</ul> + +<div id="subcommands"> +<h2> Subcommands </h2> +</div> + +<div id="help"> +<h3> help </h3> +</div> + +<p> + <tt>s6 system help</tt> prints a short help message summarizing the options +and usage of the <tt>s6 system</tt> command. It is not as detailed as this page. +</p> + +<div id="boot"> +<h3> boot </h3> +</div> + +<h4> Interface </h4> + +<pre> + s6 system boot +</pre> + +<ul> + <li> <tt>s6 system boot</tt> initializes the live directory for s6-rc +then starts all the services defined in the default bundle. In other +words, it brings the system from a state where nothing is running to +a state where everything the user wants is running. </li> + <li> This is the command that should be called as soon as the init +program hands off duties. + <ul> + <li> On a system making use of +<a href="//skarnet.org/software/s6-linux-init/">s6-linux-init/a>, +<tt>s6 system boot</tt> should be the sole command defined in the +<tt>/etc/rc.init</tt> script. </li> + <li> On a system using <tt>/etc/inittab</tt>, the first line +of the inittab should be: <tt>::wait:/usr/bin/s6 system boot</tt> </li> + </ul> </li> +</ul> + +<p> + The rest of the subcommands are shutdown subcommands, and they +only work if the machine makes use of +<a href="//skarnet.org/software/s6-linux-init/">s6-linux-init/a> and +s6-frontend has been configured to support it. On a machine that +does not boot via s6-linux-init, a shutdown should be executed via +the shutdown commands provided by your init system. In order for +the shutdown to be clean, the <code>s6 live stop_everything -E</code> +should be run before the init system performs a hard shutdown. For +instance, if the system uses <tt>/etc/inittab</tt>, then the +following line should appear in <tt>/etc/inittab</tt>: +<code>::shutdown:/usr/bin/s6 live stop_everything -E</code> +</p> + +<div id="reboot"> +<h3> reboot </h3> +</div> + +<h4> Interface </h4> + +<pre> + s6 system reboot +</pre> + +<ul> + <li> <tt>s6 system reboot</tt> reboots the machine. + <li> This only works if the machine makes use of +<a href="//skarnet.org/software/s6-linux-init/">s6-linux-init/a> and +s6-frontend has been configured to support it. </li> +</ul> + +<div id="poweroff"> +<h3> poweroff </h3> +</div> + +<h4> Interface </h4> + +<pre> + s6 system poweroff +</pre> + +<ul> + <li> <tt>s6 system poweroff</tt> halts the system and turns the +power off. </li> + <li> This only works if the machine makes use of +<a href="//skarnet.org/software/s6-linux-init/">s6-linux-init/a> and +s6-frontend has been configured to support it. </li> +</ul> + +<div id="halt"> +<h3> halt </h3> +</div> + +<h4> Interface </h4> + +<pre> + s6 system halt +</pre> + +<ul> + <li> <tt>s6 system halt</tt> halts the system without turning +the power off. </li> + <li> This only works if the machine makes use of +<a href="//skarnet.org/software/s6-linux-init/">s6-linux-init/a> and +s6-frontend has been configured to support it. </li> +</ul> + +</body> +</html> |