NAME    [Toc]    [Back]

       getpgid - Get the process group ID

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h> #include <unistd.h>

       pid_t getpgid
               pid_t pid );

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Specifies  the  process  ID  of  the  target process; zero
       implies the calling process.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       If  any  of the following conditions occurs, the getpgid()
       function sets errno to the corresponding  value:  The  pid
       argument  is  an  invalid value.  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.  No process
              was found with the specified pid value.

SEE ALSO    [Toc]    [Back]

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

       Standards: standards(5)



                                                       getpgid(2)