Manual Pages for UNIX Operating System command usage for man tcgetpgrp

Standard C Library Functions                        tcgetpgrp(3C)



NAME
     tcgetpgrp - get foreground process group ID

SYNOPSIS
     #include 
     #include 

     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  descrip-
               tor.


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


ATTRIBUTES
     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)



     ______________________________________________________________
    |       ATTRIBUTE TYPE        |        ATTRIBUTE VALUE        |
    |_____________________________|_______________________________|
    | Interface Stability         | Committed                     |
    |_____________________________|_______________________________|
    | MT-Level                    | MT-Safe, and Async-Signal-Safe|
    |_____________________________|_______________________________|
    | Standard                    | See standards(5).             |
    |_____________________________|_______________________________|


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









































SunOS 5.11          Last change: 14 Aug 2002                    2