aboutsummaryrefslogtreecommitdiffstats
s6-rc: the s6-rc-set-status program

s6-rc
Software
skarnet.org

The s6-rc-set-status program

s6-rc-set-status lists some of, or all, the services of a set, along with the rx each service is on.

Interface

     s6-rc-set-status [ -v verbosity ] [ -r repo ] [ -E | -e ] [ -L ] set [ services... ]
  • s6-rc-set-status prints the services in set set of repository repo, one per line, to stdout. If some services... are specified, it only prints the ones listed; if services... is empty, it prints all the services in the set. Each line consists of:
    • The name of the service
    • A slash (/) character
    • The canonical name for the rx the service is in.
  • It exits 0.

Options

-v verbosity, --verbosity=verbosity
Be more or less verbose. The default is 1, which means that error messages and warnings will be written to stderr. 0 means that only error messages will be written, and 2 or more adds informational messages.
-r repo, --repository=repo
Use the repository in repo, which must exist. Default is /var/lib/s6-rc/repository.
-E, --with-essentials
Do not ignore services in the always rx, i.e. services marked as essential. This is the default.
-e, --without-essentials
Ignore services in the always rx: do not print them.
-L, --list
Do not print /rx at the end of each line: only print the service names.

Exit codes

0
Success.
3
Nonexistent set.
100
Incorrect usage.
102
Invalid repository.
111
System call failed.

Notes

  • s6-rc-set-status is meant to be used with automation such as util-linux's column for formatting. A slash is used to separate the service name for the rx because slashes cannot appear in service names.