tcsetpgrp(3C)                    UNIX System V                    tcsetpgrp(3C)


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 terminal specified
      by fildes to pgid.  The file associated with fildes must be the
      controlling terminal of the calling process and the controlling terminal
      must be currently associated 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 controlling 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          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.
















10/89                                                                    Page 1