summaryrefslogtreecommitdiff
path: root/doc/s6-usertree-maker.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2021-01-08 17:48:46 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2021-01-08 17:48:46 +0000
commitdcde199cad545f33847d94e7bfa662f38559d517 (patch)
tree4fccd21b5d88cc79e1b0beef4debd0dab7a49508 /doc/s6-usertree-maker.html
parent857822a80ba63508999855221620d8c6ebd28044 (diff)
downloads6-dcde199cad545f33847d94e7bfa662f38559d517.tar.xz
s6-u-m fixes and doc fixes
Diffstat (limited to 'doc/s6-usertree-maker.html')
-rw-r--r--doc/s6-usertree-maker.html12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/s6-usertree-maker.html b/doc/s6-usertree-maker.html
index b69fbf5..38931b9 100644
--- a/doc/s6-usertree-maker.html
+++ b/doc/s6-usertree-maker.html
@@ -252,6 +252,18 @@ easier to generate programmatically and to harden than shell scripts, so it is o
built if s6 is built with <a href="//skarnet.org/software/execline/">execline</a>
support - i.e. the <tt>--disable-execline</tt> switch has <em>not</em> been given
to configure. </li>
+ <li> For the admin who wants to automate user tree management, s6-usertree-maker
+is a <em>building block</em> meant to be used in scripts, not a complete turnkey
+solution. For instance, s6-usertree-maker does not create <em>userscandir</em> for
+a user: it assumes that that scandir is already in place. It does not create
+<em>logdir</em> either: <em>logdir</em>, or at least its parent directory, must
+already exist before the logger is run, else <a href="s6-log.html">s6-log</a> will
+fail repeatedly. Make sure that all the data and metadata referenced by the service's
+and the logger's run scripts are actually present and valid before starting the
+service. </li>
+ <li> If s6-usertree-maker encounters failure (and exits 111), it does not clean up
+the directories it created. Make sure to always test s6-usertree-maker's return code
+and clean up after it if needed. </li>
</ul>
</body>