setsid: document fork(2) usage

Addresses: https://github.com/karelzak/util-linux/issues/518
Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/Documentation/TODO b/Documentation/TODO
index f81030c151c7bfee39265a91a263b3ffb96b0b91..aab16afb078f4efdc7f9445ced762c53d1724161 100644 (file)
--- a/Documentation/TODO
+++ b/Documentation/TODO
@@ -45,6 +45,11 @@ cleanup lib/path.c:
      to /sys snapshots (e.g. lsblk regression tests)
        
 
+setsid
+------
+  - add --fork to always call fork(2) before setsid(2)
+    https://github.com/karelzak/util-linux/issues/518
+
 lscpu
 -----
   - read cpuid and uname information from file if --sysroot is specified, then

diff --git a/sys-utils/setsid.1 b/sys-utils/setsid.1
index 67c4208a7cc8e17e740ccbf71717be87f574d809..61b13ce1db7ec603e77874d5e97f1d8397cad7d4 100644 (file)
--- a/sys-utils/setsid.1
+++ b/sys-utils/setsid.1
@@ -10,7 +10,10 @@ setsid \- run a program in a new session
 .RI [ arguments ]
 .SH DESCRIPTION
 .B setsid
-runs a program in a new session.
+runs a program in a new session. The command calls
+.BR fork (2)
+if already a process group leader. Otherwise, it executes a program in the
+current process.
 .SH OPTIONS
 .TP
 .BR \-c , " \-\-ctty"