Standard C Library Functions                        tcgetpgrp(3C)



NAME
     tcgetpgrp - get foreground process group ID

SYNOPSIS
     #include 
     #include 

     pidt 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.

ERORS
     The tcgetpgrp() function will fail if:

     EBADF     The fildes argument is not a valid  file  descrip-
               tor.


     ENOTY    The calling process does not  have  a  controlling
               terminal,  or the file is not the controlling ter-
               minal.


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








SunOS 5.11          Last change: 14 Aug 2002                    1






Standard C Library Functions                        tcgetpgrp(3C)



     
           ATRIBUTE TYPE                ATRIBUTE VALUE        
    
     Interface Stability          Standard                      
    
     MT-Level                     MT-Safe, and Async-Signal-Safe
    


SEE ALSO
     setpgid(2), setsid(2), tcsetpgrp(3C),  attributes(5),  stan-
     dards(5), termio(7I)











































SunOS 5.11          Last change: 14 Aug 2002                    2