NAME

getpgid − 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 standards as follows:

getpgid(): XSH4.2, XSH5.0

Refer to standards(5) for more information about industry standards and associated tags. 

PARAMETERS

pidSpecifies the process ID of the target process; zero implies the calling 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:

[EINVAL]
The pid argument is an invalid value. 

[EPERM]
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. 

[ERSCH]
No process was found with the specified pid value. 

SEE ALSO

Functions: exec(2), fork(2), setpgid(2)

Standards: standards(5)