---
name: "runsvstat"
section: "8"
platform: "linux"
package: "runit"
version: "1.0.5-3"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/runsvstat"
---

# runsvstat(8)

prints the status of services monitored by runsv(8).

## NAME

runsvstat - prints the status of services monitored by [**runsv**(8)](/runsv/8.md).

## SYNOPSIS

**runsvstat** \[ **-l** \] *services*

## DESCRIPTION

*services* consists of one or more arguments, each argument naming a directory.

**runsvstat** checks for each directory if [**runsv**(8)](/runsv/8.md) is successfully running this *service*, and if so, prints one human-readable line reporting the status of this *service*. Optionally [**runsvstat**(8)](/runsvstat/8.md) prints a second line, also in human-readable format, reporting the status of the corresponding *log* *service*.

## OPTIONS

- **-l**

  log service. Check for each *service* if there exists a corresponding *log* *service*. If so, print an additional, indented, line reporting the status of the *log* *service*.

## EXIT CODES

**runsvstat** exits 0, if the states of all *services* were reported successfully.

For each *service* that caused an error (e.g. the directory is not controlled by a [**runsv**(8)](/runsv/8.md) process), **runsvstat** increases the exit code by one and exits non zero. The maximum is 100.

**runsvstat** exits 111 on error.

## SEE ALSO

[runsv(8)](/runsv/8.md), [runsvctrl(8)](/runsvctrl/8.md), [chpst(8)](/chpst/8.md), [svlogd(8)](/svlogd/8.md), [runit(8)](/runit/8.md), [runit-init(8)](/runit-init/8.md), [runsvdir(8)](/runsvdir/8.md), [runsvchdir(8)](/runsvchdir/8.md), [svwaitdown(8)](/svwaitdown/8.md), [svwaitup(8)](/svwaitup/8.md)

 http://smarden.org/runit/

## AUTHOR

Gerrit Pape \<pape@smarden.org\>