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