Better setpgid(2) documentation.
authorHasso Tepper <hasso@dragonflybsd.org>
Wed, 5 Sep 2007 08:23:43 +0000 (08:23 +0000)
committerHasso Tepper <hasso@dragonflybsd.org>
Wed, 5 Sep 2007 08:23:43 +0000 (08:23 +0000)
Obtained-from: NetBSD with modifications

lib/libc/sys/setpgid.2

index fee35d6..dfc3ab7 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)setpgid.2  8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/setpgid.2,v 1.5.2.7 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/setpgid.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
+.\" $DragonFly: src/lib/libc/sys/setpgid.2,v 1.4 2007/09/05 08:23:43 hasso Exp $
 .\"
 .Dd June 4, 1993
 .Dt SETPGID 2
@@ -57,6 +57,11 @@ to the specified
 If
 .Fa pid
 is zero, then the call applies to the current process.
+If
+.Ar pgrp
+is zero, then the process id of the process specified by
+.Ar pid
+is used instead.
 .Pp
 If the invoker is not the super-user, then the affected process
 must have the same effective user-id as the invoker or be a descendant
@@ -74,12 +79,26 @@ versions of
 .Fn Setpgid
 will fail and the process group will not be altered if:
 .Bl -tag -width Er
-.It Bq Er ESRCH
-The requested process does not exist.
+.It Bq Er EACCES
+The value of the
+.Fa pid
+argument matches the process ID of a child process of the calling
+process, and the child process has successfully executed one of the
+.Xr exec 3
+functions.
+.It Bq Er EINVAL
+The value of the
+.Fa pgrp
+is not legal (less than zero).
 .It Bq Er EPERM
 The effective user ID of the requested process is different
 from that of the caller and the process is not a descendent
 of the calling process.
+.It Bq Er ESRCH
+The value of the
+.Fa pid
+argument does not match the process ID of the calling process
+or of a child process of the calling process.
 .El
 .Sh SEE ALSO
 .Xr getpgrp 2