Index Click this button to go to the index for this section.


getpgid(2)

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

pid Specifies 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, DIGITAL UNIX 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)