aboutsummaryrefslogtreecommitdiff
path: root/lib/libc/sys/getpgrp.2
diff options
context:
space:
mode:
authorDima Dorfman <dd@FreeBSD.org>2001-04-14 02:34:59 +0000
committerDima Dorfman <dd@FreeBSD.org>2001-04-14 02:34:59 +0000
commit161897cfcbfe6b86a4749a2092a7fe30f75c37be (patch)
treea149ef3c2ec41a1badde822269eaa646d51edee7 /lib/libc/sys/getpgrp.2
parentd81349c6ddfc442763f14d853b0ad270f1789b1c (diff)
downloadsrc-161897cfcbfe6b86a4749a2092a7fe30f75c37be.tar.gz
src-161897cfcbfe6b86a4749a2092a7fe30f75c37be.zip
Add ``RETURN VALUES'' and ``ERRORS'' sections since getpgid(2) can
fail. Also fix a minor grammar nit (it's -> its). PR: 26520
Notes
Notes: svn path=/head/; revision=75502
Diffstat (limited to 'lib/libc/sys/getpgrp.2')
-rw-r--r--lib/libc/sys/getpgrp.219
1 files changed, 18 insertions, 1 deletions
diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2
index 8e5670825ab3..11b0063fa5fe 100644
--- a/lib/libc/sys/getpgrp.2
+++ b/lib/libc/sys/getpgrp.2
@@ -76,6 +76,23 @@ and
.Fn tcsetpgrp
calls
are used to get/set the process group of the control terminal.
+.Sh RETURN VALUES
+The
+.Fn getpgrp
+call always succeeds.
+Upon successful completion, the
+.Fn getpgid
+call returns the process group of the specified process;
+otherwise, it returns a value of \-1 and sets
+.Va errno
+to indicate the error.
+.Sh ERRORS
+.Fn getpgid
+will succeed unless:
+.Bl -tag -width Er
+.It Bq Er ESRCH
+there is no process whose process ID equals fo
+.Fa pid
.Sh SEE ALSO
.Xr getsid 2 ,
.Xr setpgid 2 ,
@@ -87,7 +104,7 @@ function call appeared in
.Bx 4.0 .
The
.Fn getpgid
-function call is derived from it's usage in System V Release 4.
+function call is derived from its usage in System V Release 4.
.Sh STANDARDS
The
.Fn getpgrp