service-status, svstat — daemontools compatibility service status display
service-status
[--long] [--colour] [--log-lines lines
] {directory
...}
svstat
{directory
...}
service-status displays human-readable (but not necessarily machine parseable) information about a service that may be currently managed by service-manager(1) (or runit's runsv(1), s6's s6-supervise(1), daemontools' supervise(1), or daemontools-encore's supervise(1)).
Each directory
is either a supervise directory or a daemontools-style service directory with a supervise directory named supervise
within it.
For more on service and supervise directories, see service-manager(1).
If the standard output is a terminal, service-status uses whatever it can find via the terminfo library to display various parts of the output in different colours, highlighting different service states in different colours for example. The --colour command line option tells it to do this unconditionally, even if its standard output is not a terminal.
The --long command line option switches from the default 1-line output form to a multiple-line form.
This form includes the service's configured enable/disable state, information about its "main" process, and (if it has an associated service accessible via the conventional log/
name that in turn has its log directory accessible via the conventional main/
name) the tail end of the service's log, post-processed by the tai64nlocal(1) command.
The --log-lines command passes lines
to the tail(1) command with its -n option.
Ready-after-run services have their states reported slightly different to other services.
Such a service that is in the "stopped" daemontools-encore state will be reported as "done" if its run
program has been run at least once.
Such a service that is in the "running" daemontools-encore state will be reported as "started" if its run
program is still running and "ready" otherwise.