tcsetpgrp(3C)        COMPATIBILITY FUNCTIONS        tcsetpgrp(3C)



NAME
     tcsetpgrp - set terminal foreground process group id

SYNOPSIS
     #include <unistd.h>

     int tcsetpgrp (int fildes, pid_t pgid)

DESCRIPTION
     tcsetpgrp sets the foreground process group ID of the termi-
     nal  specified  by fildes to pgid.  The file associated with
     fildes must be the controlling terminal of the calling  pro-
     cess  and the controlling terminal must be currently associ-
     ated with the session of the calling process.  The value  of
     pgid  must match a process group ID of a process in the same
     session as the calling process.

     tcsetpgrp fails if one or more of the following is true:

     EBADF          The fildes  argument  is  not  a  valid  file
                    descriptor.

     EINVAL         The fildes argument is a terminal  that  does
                    not support tcsetpgrp, or pgid is not a valid
                    process group ID.

     ENOTTY         The calling process does not have a  control-
                    ling  terminal,  or  the file is not the con-
                    trolling terminal, or the controlling  termi-
                    nal  is no longer associated with the session
                    of the calling process.

     EPERM          pgid does not match the process group  ID  of
                    an  existing  process  in the same session as
                    the calling process.

SEE ALSO
     tcsetpgrp(3C), tcsetsid(3C).
     termio(7) in the System Administrator's Reference Manual.

DIAGNOSTICS
     Upon successful completion, tcsetpgrp returns a value of  0.
     Otherwise,  a  value  of  -1 is returned and errno is set to
     indicate the error.











                          Last change:                          1