Index for Section 2

Alphabetical listing for G

Bottom of page

getpgid(2)
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
  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:

  [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)

Index for Section 2

Alphabetical listing for G

Top of page