about summary refs log tree commit diff
path: root/doc/s6-svstat.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2015-01-19 16:11:24 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2015-01-19 16:11:24 +0000
commit701540827e27a4f07ac725db3ce361d3be0c106f (patch)
tree98c4b2fb8ba8f69ef791feebdcd61cd5bca34140 /doc/s6-svstat.html
parent83853a80eb18238796154164f9ea776b0c167ab7 (diff)
downloads6-701540827e27a4f07ac725db3ce361d3be0c106f.tar.gz
s6-701540827e27a4f07ac725db3ce361d3be0c106f.tar.xz
s6-701540827e27a4f07ac725db3ce361d3be0c106f.zip
- added the s6_fdholder library to libs6. (Nothing useful yet.)
 - fixed execline invocation in s6-log with slashpackage
 - integrated s6_svc_main.c's functionality into s6-svscanctl and deleted it
 - integrated Olivier Brunel's suggestions for wstat report in supervise/status
 - minor fixes to s6-supervise's status reports
 - separated sigaction calls in ftrigw_notifyb, this spares a few syscalls in s6-supervise
 - updated doc to reflect the changes
 - version bumped to 2.1.0.0 because API breakage (./finish, s6-svstat)
Diffstat (limited to 'doc/s6-svstat.html')
-rw-r--r--doc/s6-svstat.html25
1 files changed, 18 insertions, 7 deletions
diff --git a/doc/s6-svstat.html b/doc/s6-svstat.html
index 75ee7e2..e5e5438 100644
--- a/doc/s6-svstat.html
+++ b/doc/s6-svstat.html
@@ -18,27 +18,38 @@
 <h1> The s6-svstat program </h1>
 
 <p>
-s6-svstat prints a short, human-readable summary of the state of a supervised
-service.
+s6-svstat prints a short, human-readable summary of the state of a process
+monitored by <a href="s6-supervise.html">s6-supervise</a>.
 </p>
 
 <h2> Interface </h2>
 
 <pre>
-     s6-svstat <em>servicedir</em>
+     s6-svstat [ -n ] <em>servicedir</em>
 </pre>
 
 <p>
- s6-svstat gives the following information about the process being monitored
+ s6-svstat gives information about the process being monitored
 at the <em>servicedir</em> <a href="servicedir.html">service directory</a>, then
-exits 0:
+exits 0. The information includes the following:
 </p>
 
 <ul>
- <li> whether it is up or down </li>
- <li> its pid, if it is up </li>
+ <li> whether the process is up or down </li>
+ <li> the process' pid, if it is up, or its last exit code or terminating
+signal, if it is down </li>
  <li> what its default state is, if it is different from its current state </li>
  <li> the number of seconds since it last changed states </li>
+ <li> if the current state is transient and will change as soon as the
+kernel's scheduler picks up s6-supervise </li>
+</ul>
+
+<h2> Options </h2>
+
+<ul>
+ <li> <tt>-n</tt>&nbsp;: if the monitored process has been killed by a signal,
+print the signal number. By default, a symbolic name for the signal will be
+printed instead. </li>
 </ul>
 
 </body>