From 0476de6678999de038a1803577d2c0d7faa751ee Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Thu, 24 Sep 2020 17:03:55 +0000 Subject: Document nosetsid --- doc/servicedir.html | 13 +++++++++---- 1 file 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. the default state of the service is considered down, not up: s6-supervise will not automatically start it until it receives a s6-svc -u command. If no down file exists, the default state of the service is up. -
  • An optional, empty, regular file named nosetsid. 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 nosetsid file -exists, the service has its own process group and is started as a session leader.
    • +
  • An optional, empty, regular file named nosetsid. +If this file exists and starts with the word setpgrp, 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 does not start with setpgrp, +s6-supervise will start the service in the same session and process group as itself. +If no nosetsid 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 +nosetsid file is a hack; it should only be used in testing environments for +job control convenience, and probably never outside that use case.
  • An optional regular file named notification-fd. If such a file exists, it means that the service supports readiness notification. The file must only -- cgit v1.2.3