NAME

getpgid - Gets process group ID

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <sys/types.h> #include <unistd.h> pid_t getpgid(
pid_t pid);

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:

[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.  As released, DEC OSF/1 does not check the privilege. 

[ERSCH]No process has been found that has a process ID identical to that specified by the pid parameter. 

RELATED INFORMATION

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