s6-rc: the s6-rc-set-status program
Keywords: s6-rc s6-rc-set-status repo set rx list services status

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.