summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2018-04-20 15:32:05 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2018-04-20 15:32:05 +0000
commit6577467acca3fd281273b95c3906a85dbf19e6f8 (patch)
tree5759d99fb05dd14fc5d0d8fdf3a7b4b88556d119 /doc
parenta9ac71ac2a874760466f673732610c2cc186797a (diff)
downloads6-6577467acca3fd281273b95c3906a85dbf19e6f8.tar.xz
Add -d notif to s6-svscan; this is only shallow readiness.
Diffstat (limited to 'doc')
-rw-r--r--doc/s6-svscan.html13
-rw-r--r--doc/upgrade.html9
2 files changed, 21 insertions, 1 deletions
diff --git a/doc/s6-svscan.html b/doc/s6-svscan.html
index 4bb943b..665fd75 100644
--- a/doc/s6-svscan.html
+++ b/doc/s6-svscan.html
@@ -27,7 +27,7 @@ the root or a branch of a <em>supervision tree</em>.
<h2> Interface </h2>
<pre>
- s6-svscan [ -S | -s ] [ -c max ] [ -t <em>rescan</em> ] [ <em>scandir</em> ]
+ s6-svscan [ -S | -s ] [ -d <em>notif</em> ] [ -c max ] [ -t <em>rescan</em> ] [ <em>scandir</em> ]
</pre>
<ul>
@@ -62,6 +62,17 @@ execution. </li>
<li> <tt>-S&nbsp;</tt>&nbsp;: do not divert signals. This is the default for now;
it may change in a future version of s6. </li>
<li> <tt>-s&nbsp;</tt>&nbsp;: divert signals - see below. </li>
+ <li> <tt>-d&nbsp;<em>notif</em></tt>&nbsp;: notify readiness on file descriptor
+<em>notif</em>. When s6-svscan is ready to accept commands from
+<a href="s6-svscanctl.html">s6-svscanctl</a>, it will write a newline to <em>notif</em>.
+<em>notif</em> cannot be lesser than 3. By default, no notification is sent. Please
+note that using this option signals <em>shallow readiness</em>: s6-svscan being
+"ready" only means that it is ready to accept commands. It <em>does not mean</em>
+that all the services it launches at start are themselves ready, or even started, or
+even that the relevant <a href="s6-supervise.html">s6-supervise</a> processes have
+been started. If you need to test for <em>deep readiness</em>, meaning that all the
+services in the supervision tree have been started and are ready, you cannot rely
+on this option. </li>
<li> <tt>-c&nbsp;<em>max</em></tt>&nbsp;: maintain services for up to <em>max</em>
service directories. Default is 500. Lower limit is 2. There is no upper limit, but:
<ul>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 3e2a538..4ea789c 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -18,6 +18,15 @@
<h1> What has changed in s6 </h1>
+<h2> in 2.7.2.0 </h2>
+
+<ul>
+ <li> <tt>-B</tt> option added to
+<a href="s6-ipcserver-socketbinder.html">s6-ipcserver-socketbinder</a>. </li>
+ <li> <tt>-d&nbsp;<em>notif</em></tt> option added to
+<a href="s6-svscan.html">s6-svscan</a>. </li>
+</ul>
+
<h2> in 2.7.1.1 </h2>
<ul>