From d210073f360d1af7cf9acc36925eda15d17c67d6 Mon Sep 17 00:00:00 2001 From: Colin Booth Date: Thu, 22 Jan 2026 22:18:47 +0000 Subject: s6_live.html: minor text and link cleanup note: expects an id in s6-rc-update.html for converesion files --- doc/s6_live.html | 32 +++++++++++++++----------------- 1 file changed, 15 insertions(+), 17 deletions(-) (limited to 'doc') diff --git a/doc/s6_live.html b/doc/s6_live.html index 1c0cc33..dc3b299 100644 --- a/doc/s6_live.html +++ b/doc/s6_live.html @@ -20,7 +20,7 @@

The s6 live command

- s6 live regroups actions that target the live machine state + s6 live groups actions that target the live machine state managed by the s6-rc service manager, hosted in the configured livedir.

@@ -28,9 +28,10 @@ hosted in the configured livedir.

Where s6 process directly targets instances of services supervised by s6-supervision, -without knowledge of the service manager, and thus can only address longruns, -s6 live targets services defined in the current live database, oneshots -as well as longruns, and always respects the dependency graph. +without knowledge of the service manager it can only address longruns. On the +other hand, s6 live targets services defined in the current live +database, oneshots as well as longruns, and will always respect the dependency +graph.

Interface

@@ -211,7 +212,7 @@ The default is default, possibly overridden by the @@ -227,7 +228,7 @@ it can more or less run and be interacted with, even if in a completely bare state. This is the default.
-E, --with-essentials
-
Also stop essential services. After this command, the machine +
Also stop essential services. After this command the machine isn't good for much except a reboot. s6 live stop-everything -E is the command that should be run right before a shutdown when the system is not using s6-linux-init. To that end, the line @@ -254,10 +255,9 @@ command can wait forever.
of services, that has been crafted and committed via s6 set commands, replacing the current live service database. -
  • Services that are not defined in the new set are stopped before the -live database is replaced.
    • -
  • The state of services defined in the old live database is preserved -as much as possible.
    • +
  • The state of services defined in the old live database is preserved as +much as possible, though services that are not defined in the new set are +stopped before the live database is replaced.

    • Options

    @@ -272,10 +272,9 @@ database. The default is to fail with an error message instead. Instead, print its path to stdout.
    -f convfile, --conversion-file=convfile
    -
    Use convfile as a conversion file for the underlying +
    Use convfile as a conversion file for the underlying s6-rc-update -invocation, i.e. a file translating service names and states between -the old service database and the one being installed. This option should +invocation. This option should never be necessary if the services in the stores are properly managed.
    --init
    @@ -283,10 +282,9 @@ never be necessary if the services in the stores are properly managed. Copy the compiled database of the current working set to the place where it can be booted on, but do not call s6-rc-update. -This is only useful for a first installation of s6-frontend, when -s6-rc is not managing the live services yet. Once a reboot has been done -and the machine is successfully running with s6-rc, this option should -never be used again. +This is only useful for a first installation of s6-frontend, before +s6-rc is managing live services. This option should never be used once a reboot +has been performed and the machine is successfully running with s6-rc. -- cgit v1.3.1