tcgetpgrp(3C)




NAME

     tcgetpgrp - get foreground process group ID


SYNOPSIS

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

     pid_t tcgetpgrp(int fildes);


DESCRIPTION

     The tcgetpgrp() function will return the value of  the  pro-
     cess  group  ID  of  the foreground process group associated
     with the terminal.

     If there is no foreground process group, tcgetpgrp() returns
     a value greater than 1 that does not match the process group
     ID of any existing process group.

     The tcgetpgrp() function is allowed from a process that is a
     member  of a background process group; however, the informa-
     tion may be subsequently changed by  a  process  that  is  a
     member of a foreground process group.


RETURN VALUES

     Upon successful completion, tcgetpgrp() returns the value of
     the  process  group  ID of the foreground process associated
     with the terminal.  Otherwise, -1 is returned and  errno  is
     set to indicate the error.


ERRORS

     The tcgetpgrp() function will fail if:

     EBADF The fildes argument is not a valid file descriptor.

     ENOTTY
           The calling process does not have a controlling termi-
           nal, or the file is not the controlling terminal.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ______________________________________________________________
    |       ATTRIBUTE TYPE        |        ATTRIBUTE VALUE        |
    |_____________________________|_______________________________|
    | MT-Level                    | MT-Safe, and Async-Signal-Safe|
    |_____________________________|_______________________________|


SEE ALSO

     setpgid(2),   setsid(2),    tcsetpgrp(3C),    attributes(5),
     termio(7I)

Man(1) output converted with man2html