NAME    [Toc]    [Back]

     tcgetpgrp - get foreground process group ID

SYNOPSIS    [Toc]    [Back]

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

     pid_t
     tcgetpgrp(int fd);

DESCRIPTION    [Toc]    [Back]

     The tcgetpgrp() function returns the value  of  the  process
group ID of the
     foreground  process  group  associated with the terminal device.  If there
     is no foreground process group, tcgetpgrp() returns  an  invalid process
     ID.

ERRORS    [Toc]    [Back]

     If  an  error  occurs, tcgetpgrp() returns -1 and the global
variable errno
     is set to indicate the error, as follows:

     [EBADF]       The fd argument is not a valid  file  descriptor.

     [ENOTTY]       The  calling process does not have a controlling terminal or
                   the underlying terminal device represented  by
fd is not the
                   controlling terminal.

SEE ALSO    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

     The  tcgetpgrp()  function  is expected to be compliant with
the IEEE Std
     1003.1-1988 (``POSIX'') specification.

OpenBSD     3.6                          March      29,      1992