NAME    [Toc]    [Back]

       tcgetpgrp - Get foreground process group ID

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       pid_t tcgetpgrp(
               int filedes );

       Application  developers  may  want  to specify an #include
       statement for <sys/types.h> before the one for  <unistd.h>
       if  programs  are  being developed for multiple platforms.
       The additional #include statement is not required on Tru64
       UNIX  systems  or  by  ISO or X/Open standards, but may be
       required on other vendors' systems that conform  to  these
       standards.

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       tcgetpgrp():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Indicates  the  open file descriptor for the terminal special
 file.

DESCRIPTION    [Toc]    [Back]

       The tcgetpgrp() function returns the value of the  process
       group  ID  of the foreground process group associated with
       the terminal. The function can be called from a background
       process;  however,  the  information  may  be subsequently
       changed by the foreground process.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the process group  ID  of  the
       foreground  process  is returned. Otherwise, a value of -1
       is returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       The tcgetpgrp() function sets errno to the specified  values
 for the following conditions: The filedes parameter is
       not a valid file descriptor.  The calling process does not
       have  a  controlling  terminal or the file is not the controlling
 terminal.

SEE ALSO    [Toc]    [Back]

       Functions: setpgid(2), setsid(2), tcsetpgrp(3)

       Standards: standards(5)



                                                     tcgetpgrp(3)