summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2017-05-16 14:25:30 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2017-05-16 14:25:30 +0000
commitee7925ff752efa272d335bca53240abca9256f6f (patch)
tree01fd1f6cec6c95427b313306906ee1bb8dd91c5c /doc
parent9a81557a41d295f026ddb021090ddf18828e733a (diff)
downloads6-rc-ee7925ff752efa272d335bca53240abca9256f6f.tar.xz
Add -d option to s6-rc-init, to dereference compiled
Diffstat (limited to 'doc')
-rw-r--r--doc/s6-rc-init.html13
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/s6-rc-init.html b/doc/s6-rc-init.html
index f24c20a..c0ae6fc 100644
--- a/doc/s6-rc-init.html
+++ b/doc/s6-rc-init.html
@@ -32,8 +32,8 @@ invocation of the
</pre>
<ul>
- <li> <em>compiled</em>, <em>live</em> and <em>scandir</em> must be
-absolute paths. </li>
+ <li> <em>compiled</em> (if the <tt>-d</tt> option hasn't been given),
+<em>live</em> and <em>scandir</em> must be absolute paths. </li>
<li> s6-rc-init expects to find a <em>compiled service database</em>
in <em>compiled</em>. It expects to be able to create a directory
named <em>live</em>. It also expects that an instance of
@@ -79,6 +79,15 @@ being used by another program, s6-rc-init will wait until that
other program has released its lock on the database, then proceed.
By default, s6-rc-init fails with an error message if the database
is currently in use. </li>
+ <li><tt>-d</tt>&nbsp;: dereference <em>compiled</em>. Fully resolve
+the <em>compiled</em> path before declaring it as the current
+compiled service database for the upcoming live state. This allows
+<em>compiled</em> to be a symlink that can be updated later without
+impacting the current live state. Using this flag in your init scripts'
+<tt>s6-rc-init</tt> invocation means that it's possible to boot on a
+compiled service database whose validity has not previously been
+guaranteed by a successful <a href="s6-rc-update.html">s6-rc-update</a>
+invocation: you should know what you are doing. </li>
</ul>
<h2> Typical usage </h2>