getpgid(2)getpgid(2)NAMEgetpgid - Get the process group ID
SYNOPSIS
#include <sys/types.h> #include <unistd.h>
pid_t getpgid
pid_t pid );
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
getpgid(): XSH4.2, XSH5.0
Refer to standards(5) for more information about industry standards and
associated tags.
PARAMETERS
Specifies the process ID of the target process; zero implies the call‐
ing process.
DESCRIPTION
The getpgid() function returns the process group ID of the process
specified by the process ID pid. Specifying a pid of 0 (zero) returns
the process group ID of the calling process.
RETURN VALUES
The getpgid() function returns the process group ID of the process
specified. If there was an error, a value of -1 is returned and errno
is set to indicate the error.
ERRORS
If any of the following conditions occurs, the getpgid() function sets
errno to the corresponding value: The pid argument is an invalid value.
The specified process is not in the same session as the calling
process, and the calling process lacks sufficient privilege to read the
specified process.
On Tru64 UNIX systems, special privileges are not a requirement
for using this function. No process was found with the speci‐
fied pid value.
SEE ALSO
Functions: exec(2), fork(2), setpgid(2)
Standards: standards(5)getpgid(2)
