diff --git a/ChangeLog b/ChangeLog index 6ede713174..5b7df36b19 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +1999-08-15 Andreas Jaeger + + * manual/job.texi (Process Group Functions): Document getpgid, + getsid. + 1999-08-15 Ulrich Drepper * sysdeps/unix/sysv/linux/aio_sigqueue.c: Take extra parameter and diff --git a/manual/job.texi b/manual/job.texi index 44b8783299..b0374a7b34 100644 --- a/manual/job.texi +++ b/manual/job.texi @@ -1095,6 +1095,29 @@ already another process group around that has the same process group ID. @end table @end deftypefun +@comment unistd.h +@comment SVID +@deftypefun pid_t getsid (pid_t @var{pid}) + +The @code{getsid} function returns the process group ID of the session +leader of the specified process. If a @var{pid} is @code{0}, the +process group ID of the session leader of the current process is +returned. + +In case of error @code{-1} is returned and @code{errno} is set. The +following @code{errno} error conditions are defined for this function: + +@table @code +@item ESRCH +There is no process with the given process ID @var{pid}. +@item EPERM +The calling process and the process specified by @var{pid} are in +different sessions, and the implementation doesn't allow to access the +process group ID of the session leader of the process with ID @var{pid} +from the calling process. +@end table +@end deftypefun + The @code{getpgrp} function has two definitions: one derived from BSD Unix, and one from the POSIX.1 standard. The feature test macros you have selected (@pxref{Feature Test Macros}) determine which definition @@ -1123,6 +1146,28 @@ process @var{pid}. You can supply a value of @code{0} for the @var{pid} argument to get information about the calling process. @end deftypefn +@comment unistd.h +@comment SVID +@deftypefn {System V Function} int getpgid (pid_t @var{pid}) + +@code{getpgid} is the same as the BSD function @code{getpgrp}. It +returns the process group ID of the process @var{pid}. You can supply a +value of @code{0} for the @var{pid} argument to get information about +the calling process. + +In case of error @code{-1} is returned and @code{errno} is set. The +following @code{errno} error conditions are defined for this function: + +@table @code +@item ESRCH +There is no process with the given process ID @var{pid}. +The calling process and the process specified by @var{pid} are in +different sessions, and the implementation doesn't allow to access the +process group ID of the process with ID @var{pid} from the calling +process. +@end table +@end deftypefun + @comment unistd.h @comment POSIX.1 @deftypefun int setpgid (pid_t @var{pid}, pid_t @var{pgid})