TCSETPGRP(3C-SVR4)  RISC/os Reference Manual   TCSETPGRP(3C-SVR4)



NAME
     tcsetpgrp - set terminal foreground process group id

SYNOPSIS
     #include <unistd.h>

     int tcsetpgrp (int fildes, pidt 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
     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.











                        Printed 11/19/92                   Page 1