Index for Section 2

Alphabetical listing for G

Bottom of page

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, Tru64 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)

Index for Section 2

Alphabetical listing for G

Top of page