service-status 1 user commands nosh
service-status svstat daemontools compatibility service status display
`service-status` --long --colour --log-lines lines directory `svstat` directory

## Description

`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 TerminalCapabilities 3 and an `ECMA48Output` instance 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.

## Compatibility

For daemontools and daemontools-encore compatibility, this command is also available as `svstat`.

## Author

Jonathan de Boyne Pollard