summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2018-03-20 18:21:19 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2018-03-20 18:21:19 +0000
commit01c12e7ac7bd0c95099dbe299f049c59081e35bc (patch)
tree6f6a784dd3c1730fda2072f7af97e23e37f44335 /doc
parent3b8083f63e774b30963948778e01553d85cfea29 (diff)
downloads6-01c12e7ac7bd0c95099dbe299f049c59081e35bc.tar.xz
Add s6-svdt, change default max tally to 100, add doc, prepare for 2.7.1.0
Diffstat (limited to 'doc')
-rw-r--r--doc/index.html3
-rw-r--r--doc/s6-svdt.html70
-rw-r--r--doc/servicedir.html2
-rw-r--r--doc/upgrade.html3
4 files changed, 75 insertions, 3 deletions
diff --git a/doc/index.html b/doc/index.html
index cbc24ed..733e3ee 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -100,7 +100,7 @@ library. </li>
<h3> Download </h3>
<ul>
- <li> The current released version of s6 is <a href="s6-2.7.0.1.tar.gz">2.7.0.1</a>. </li>
+ <li> The current released version of s6 is <a href="s6-2.7.1.0.tar.gz">2.7.1.0</a>. </li>
<li> Alternatively, you can checkout a copy of the
<a href="//git.skarnet.org/cgi-bin/cgit.cgi/s6/">s6
git repository</a>:
@@ -156,6 +156,7 @@ a user interface to control those processes and monitor service states.
<li><a href="s6-svlisten1.html">The <tt>s6-svlisten1</tt> program</a></li>
<li><a href="s6-svlisten.html">The <tt>s6-svlisten</tt> program</a></li>
<li><a href="s6-notifyoncheck.html">The <tt>s6-notifyoncheck</tt> program</a></li>
+<li><a href="s6-svdt.html">The <tt>s6-svdt</tt> program</a></li>
</ul>
<h4> Daemontools-like utilities </h4>
diff --git a/doc/s6-svdt.html b/doc/s6-svdt.html
new file mode 100644
index 0000000..bb78061
--- /dev/null
+++ b/doc/s6-svdt.html
@@ -0,0 +1,70 @@
+<html>
+ <head>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>s6: the s6-svdt program</title>
+ <meta name="Description" content="s6: the s6-svdt program" />
+ <meta name="Keywords" content="s6 command s6-svdt servicedir death tally process supervision s6-supervise" />
+ <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
+ </head>
+<body>
+
+<p>
+<a href="index.html">s6</a><br />
+<a href="//skarnet.org/software/">Software</a><br />
+<a href="//skarnet.org/">skarnet.org</a>
+</p>
+
+<h1> The s6-svdt program </h1>
+
+<p>
+s6-svstat prints the recorded death tally of a service, i.e. a list of the times
+the process died, with the cause of death.
+</p>
+
+<h2> Interface </h2>
+
+<pre>
+ s6-svdt [ -S | -s ] [ -n <em>maxlines</em> ] <em>servicedir</em>
+</pre>
+
+<p>
+ s6-svdt prints the contents of the recorded death tally of the service being
+currently supervised at the <em>servicedir</em>
+<a href="servicedir.html">service directory</a>, then exits 0.
+</p>
+
+<p>
+ For each recorded death, s6-svdt prints one line. This line contains the
+following fields, separated with spaces:
+</p>
+
+<ul>
+ <li> A <a href="https://cr.yp.to/daemontools/tai64n.html">TAI64N</a>
+timestamp .</li>
+ <li> The word "signal" if the death was caused by a signal, or the word
+"exitcode" if the death was a normal exit. </li>
+ <li> The name of the signal that caused the death, or the exit code
+of the process. </li>
+
+<h2> Options </h2>
+
+<ul>
+ <li> <tt>-S</tt>&nbsp;: print signal names. This is the default. </li>
+ <li> <tt>-s</tt>&nbsp;: print signal numbers. The numerical value of the signal
+will be printed instead of the signal name. </li>
+ <li> <tt>-n&nbsp;<em>maxlines</em></tt>&nbsp;: limit the output to at most
+the latest <em>maxlines</em> deaths. </li>
+</ul>
+
+<h2> Exit codes </h2>
+
+<ul>
+ <li> 0: success </li>
+ <li> 100: wrong usage </li>
+ <li> 111: system call failed </li>
+</ul>
+
+</body>
+</html>
diff --git a/doc/servicedir.html b/doc/servicedir.html
index cad2cb4..29236e7 100644
--- a/doc/servicedir.html
+++ b/doc/servicedir.html
@@ -148,7 +148,7 @@ exists, it must only contain an unsigned integer, which is the maximum number of
service death events that s6-supervise will keep track of. If the service dies
more than this number of times, the oldest events will be forgotten. Tracking
death events is useful, for instance, when throttling service restarts. The
-value cannot be greater than 4096. If the file does not exist, a default of 20
+value cannot be greater than 4096. If the file does not exist, a default of 100
is used. </li>
<li> A <a href="fifodir.html">fifodir</a> named <tt>event</tt>. It is automatically
created by <a href="s6-supervise.html">s6-supervise</a> if it does not exist.
diff --git a/doc/upgrade.html b/doc/upgrade.html
index c37ad15..10f139b 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -18,10 +18,11 @@
<h1> What has changed in s6 </h1>
-<h2> in 2.7.0.1 </h2>
+<h2> in 2.7.1.0 </h2>
<ul>
<li> skalibs dependency bumped to 2.6.4.0. </li>
+ <li> New command: <a href="s6-svdt.html">s6-svdt</a>. </li>
</ul>
<h2> in 2.7.0.0 </h2>