The s6-instance-status program

s6-instance-status gives the status of a running instance of an instanced service, as a short human-readable summary or programmatically parsable output.

Interface

     s6-instance-status [ -uwNrpest | -o up,wantedup,normallyup,ready,paused,pid,exitcode,signal,signum,updownsince,readysince,updownfor,readyfor ] [ -n ] servicedir name

s6-instance-status expects a running, supervised instanced service in servicedir, as well as an existing instance of this service named name.
It prints information to stdout about the monitored instance of servicedir named name.
It exits 0.

Exit codes

0: success
100: wrong usage
111: system call failed

Options

The options are exactly the same as the ones understood by s6-svstat.

In fact, s6-instance-status is nothing more than a call to s6-svstat on the service directory representing the name instance. It is syntactic sugar so the user does not have to depend on the internal representation of instances and the location of instances' service directories.