Manual Pages for UNIX Operating System command usage for man tcsetpgrp

Standard C Library Functions                        tcsetpgrp(3C)



NAME
     tcsetpgrp - set foreground process group ID

SYNOPSIS
     #include 
     #include 

     int tcsetpgrp(int fildes, pid_t pgid_id);


DESCRIPTION
     If the process has a controlling terminal, tcsetpgrp()  will
     set the foreground process group ID associated with the ter-
     minal to pgid_id. 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 pgid_id 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.

ERRORS
     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 pgid_id argument.


     ENOTTY    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 SIGTTOU and
               is a member of an orphaned process group.


     EPERM     The value of pgid_id 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)



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



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


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




































SunOS 5.11          Last change: 14 Aug 2002                    2