unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



getpgid(2)							   getpgid(2)



NAME

  getpgid - Gets process group ID

LIBRARY

  Standard C Library (libc.a)

SYNOPSIS

  #include <&lt;sys/types.h>&gt;
  #include <&lt;unistd.h>&gt;
  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 speci-
  fied by the process ID pid.  Specifying a pid	of 0 (zero) returns the	pro-
  cess group ID	of the calling process.

RETURN VALUES

  The getpgid()	function returns the process group ID of the process speci-
  fied.	 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)