From c1dd4dd8635d59ae1078977474cd0610f074e274 Mon Sep 17 00:00:00 2001 From: Colin Booth Date: Thu, 22 Jan 2026 22:18:43 +0000 Subject: s6.html: consolidate a lot of duplicate text into a single note Note, this is missing a callout about what the default behavior is for the color option. --- doc/s6.html | 45 +++++++++++++++------------------------------ 1 file changed, 15 insertions(+), 30 deletions(-) (limited to 'doc') diff --git a/doc/s6.html b/doc/s6.html index 2ec2ce5..3b2a6fb 100644 --- a/doc/s6.html +++ b/doc/s6.html @@ -50,25 +50,25 @@ failure.

- Since it can exec into a wide variety of commands belonging to various -parts of the s6 family of programs, it is difficult to list all its possible -exit codes exhaustively. However, in case of an error, the name of the + It is difficult to exhaustively list all of the possible exit codes since it +can exec into a wide variety of commands belonging to different parts of the s6 +family of programs. However, in case of an error, the name of the subprogram where the error occurred is always printed on stderr; you can then consult the documentation for said subprogram, which will have the explanation for all its exit codes. For instance, if an invocation of s6 prints a message such as s6-rc: fatal: unable to start service foobar, it means that s6 invoked the s6-rc -command, and on the linked documentation page, you can find the interpretation +command, and on the linked documentation page you can find the interpretation of its various exit codes.

Environment variables

@@ -95,50 +95,35 @@ Any given command or subcommand is ignored.
-s scandir, --scandir=scandir
Use scandir as scan directory (i.e. the directory where s6-svscan runs -and supervises service directories), -overriding the value of scandir -defined in s6-frontend.conf.
+and supervises service directories).
-l livedir, --livedir=livedir
Use livedir as live directory (i.e. the directory where s6-rc keeps tabs -on the machine state and stores its runtime information), -and supervises service directories), -overriding the value of livedir -defined in s6-frontend.conf.
+on the machine state and stores its runtime information).
-r repodir, --repodir=repodir
Use repodir as s6-rc repository (i.e. the directory where the repo commands of the s6-rc package store -and manipulate their service sets), -overriding the value of repodir -defined in s6-frontend.conf.
+and manipulate their service sets).
-c bootdb, --bootdb=bootdb
Use bootdb as the name of the compiled service database used by s6-rc at boot time (i.e. the directory where the s6-rc reads -information on how to start all the wanted services) -overriding the value of bootdb -defined in s6-frontend.conf.
+information on how to start all the wanted services).
--stmpdir=stmpdir
Use stmpdir to store runtime s6-frontend data and -temporary files, -overriding the value of stmpdir -defined in s6-frontend.conf.
+temporary files.
--storelist=storelist
Use storelist as list of -stores, -overriding the value of storelist -defined in s6-frontend.conf.
+stores.
-v verbosity, --verbosity=verbosity
-
Use verbosity as numerical verbosity value, -overriding the value of verbosity -defined in s6-frontend.conf.
+
Use verbosity as numerical verbosity value.
--color=yes|no|auto
Use fancy output (which may or may not involve color): always if @@ -199,7 +184,7 @@ available here.

repository

- s6 repository regroups administrative tasks related to the repository + s6 repository groups administrative tasks related to the repository of service sets, typically synchronization with the service stores when the package manager updates service definitions. It is not often directly used by sysadmins, but is an essential part of distribution scripts, when they create -- cgit v1.3.1