tcsetpgrp(3P)                                       tcsetpgrp(3P)



     NAME
          tcsetpgrp - set distinguished process group ID

     SYNOPSIS
          #include <sys/types.h>

          int tcsetpgrp(fildes,pgrp-id)
          int fildes;
          pid_t pgrp-id;

     DESCRIPTION
          tcsetpgrp is part of the POSIX Job Control Option.

          If the process has a controlling terminal, tcsetpgrp sets
          the distinguished process group ID associated with the ter-
          minal to pgrp-id.  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 pgrp-id must match a
          process group ID of a process in the same session as the
          calling process.

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

     ERRORS
          [EBADF]       The file descriptor fildes is not valid.

          [EINVAL]      tcsetpgrp is not permitted for the device as-
                        sociated with fildes, or the value of pgrp-id
                        is less than or equal to 0 or exceeds PID_MAX.

          [ENOTTY]      The calling process does not have a control-
                        ling terminal, or the file is not the control-
                        ling terminal.

          [EPERM]       pgrp-id is greater than 0 and less than or
                        equal to PID_MAX, and there is no process in
                        the process group indicated by pgrp-id that
                        has the same controlling terminal as the cal-
                        ling process.

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










     April, 1990                                                     1