From efb187afd627d04e95f8e2655dd3b31213823097 Mon Sep 17 00:00:00 2001
From: dd
Date: Sat, 14 Apr 2001 02:34:59 +0000
Subject: Add ``RETURN VALUES'' and ``ERRORS'' sections since getpgid(2) can
fail. Also fix a minor grammar nit (it's -> its).
PR: 26520
---
lib/libc/sys/getpgrp.2 | 19 ++++++++++++++++++-
1 file changed, 18 insertions(+), 1 deletion(-)
diff --git a/lib/libc/sys/getpgrp.2 b/lib/libc/sys/getpgrp.2
index 8e56708..11b0063 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
--
cgit v1.1