summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2020-09-24 17:03:55 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2020-09-24 17:03:55 +0000
commit0476de6678999de038a1803577d2c0d7faa751ee (patch)
tree6067c4c65361fc9c7505ae55636dfb5f93519a02 /doc
parent6f91eb3fbcd05172de53bf011fdc49bb3b5fbffd (diff)
downloads6-0476de6678999de038a1803577d2c0d7faa751ee.tar.xz
Document nosetsid
Diffstat (limited to 'doc')
-rw-r--r--doc/servicedir.html13
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/servicedir.html b/doc/servicedir.html
index a7b9dd1..fa7f974 100644
--- a/doc/servicedir.html
+++ b/doc/servicedir.html
@@ -122,10 +122,15 @@ must be writable. </li>
the default state of the service is considered down, not up: s6-supervise will not
automatically start it until it receives a <tt>s6-svc -u</tt> command. If no
<tt>down</tt> file exists, the default state of the service is up. </li>
- <li style="margin-bottom:1em"> An optional, empty, regular file named <tt>nosetsid</tt>. If such a file exists,
-s6-supervise will not make the service a process group and session leader; the service
-will be run in the same process group as s6-supervise. If no <tt>nosetsid</tt> file
-exists, the service has its own process group and is started as a session leader. </li>
+ <li style="margin-bottom:1em"> An optional, empty, regular file named <tt>nosetsid</tt>.
+If this file exists and starts with the word <tt>setpgrp</tt>, s6-supervise will run the service
+in a new process group (the run script will be a process group leader), but not in a new session.
+If this file exists and <em>does not</em> start with <tt>setpgrp</tt>,
+s6-supervise will start the service in the same session and process group as itself.
+If no <tt>nosetsid</tt> file exists, the service has its own process group and is started
+as a session leader - which is the default and should normally not be changed. Using the
+<tt>nosetsid</tt> file is a hack; it should only be used in testing environments for
+job control convenience, and probably never outside that use case. </li>
<li style="margin-bottom:1em"> An optional regular file named <tt>notification-fd</tt>. If such a file
exists, it means that the service supports
<a href="notifywhenup.html">readiness notification</a>. The file must only