setpgrp(2)                                             setpgrp(2)



     NAME
          setpgrp - set process group ID

     SYNOPSIS
          int setpgrp()

          int setpgrp(pid,pgrp)
          int pid, pgrp;

     DESCRIPTION
          The first form of setpgrp sets the process group ID of the
          calling process to the process ID of the calling process and
          returns the new process group ID.

          The second form of setpgrp is available when the process has
          requested 4.2 BSD compatibility.  setpgrp will then set the
          process group of the specified process pid to the specified
          pgrp.  If pid is zero, then the call applies to the current
          process.

          If the user is not superuser, then the affected process must
          have the same effective user ID as the invoking user or be a
          descendant of the invoking process.

     RETURN VALUE
          Upon successful completion, a value of 0 is returned.  Oth-
          erwise, a value of -1 is returned and errno is set to indi-
          cate the error.

     ERRORS
          The setpgrp call fails if:

          [ESRCH]the process is not found.

          [EPERM]The caller is not superuser.

     SEE ALSO
          exec(2), fork(2), getpid(2), intro(2), kill(2), setcom-
          pat(2), signal(3).
















     April, 1990                                                     1