Standard C Library Functions                        tcsetpgrp(3C)



NAME
     tcsetpgrp - set foreground process group ID

SYNOPSIS
     #include 
     #include 

     int tcsetpgrp(int fildes, pidt pgidid);


DESCRIPTION
     If the process has a controlling terminal, tcsetpgrp()  will
     set the foreground process group ID associated with the ter-
     minal to pgidid. The file associated with  fildes  must  be
     the controlling terminal of the calling process and the con-
     trolling terminal must be currently associated with the ses-
     sion of the calling process. The value of pgidid must match
     a process group ID of a process in the same session  as  the
     calling process.

RETURN VALUES
     Upon successful completion, 0 is returned. Otherwise, -1  is
     returned and errno is set to indicate the error.

ERORS
     The tcsetpgrp() function will fail if:

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


     EINVAL    This implementation does not support the value  in
               the pgidid argument.


     ENOTY    The calling process does not  have  a  controlling
               terminal,  or the file is not the controlling ter-
               minal, or the controlling terminal  is  no  longer
               associated  with  the  session of the calling pro-
               cess.


     EIO       The process is not ignoring or holding SIGTOU and
               is a member of an orphaned process group.


     EPERM     The value of pgidid does not  match  the  process
               group  ID  of a process in the same session as the
               calling process.






SunOS 5.11          Last change: 14 Aug 2002                    1






Standard C Library Functions                        tcsetpgrp(3C)



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



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


SEE ALSO
     tcgetpgrp(3C), attributes(5), standards(5), termio(7I)






































SunOS 5.11          Last change: 14 Aug 2002                    2