TCSETPGRP(3-POSIX)  RISC/os Reference Manual   TCSETPGRP(3-POSIX)



NAME
     tcsetpgrp - set foreground process group ID

SYNOPSIS
     #include <sys/types.h>

     pidt tcsetpgrp(fildes, pgrpid)
     int fildes;
     pidt pgrpid;

DESCRIPTION
     tcsetpgrp sets the process group ID of the foreground pro-
     cess group associated with the terminal to pgrp_id.  The
     file associated with fildes must be the controlling terminal
     of the calling process and the controlling terminal must
     currently be associated with the session of the calling pro-
     cess.  pgrp_id must match a process group ID of a process in
     the same session as the calling process.

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

ERRORS
     If any of the following conditions occur, tcsetpgrp returns
     -1 and sets errno to the corresponding value:

     [EBADF]             fildes is not a valid file descriptor.

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

     [EPERM]             pgrp_id does not match the process group
                         ID of a process in the same session as
                         the calling process.

SEE ALSO
     setsid(2), setpgid(2), tcgetpgrp(3).














                         Printed 1/15/91                   Page 1