SETPGRP(2-BSD)      RISC/os Reference Manual       SETPGRP(2-BSD)



NAME
     setpgrp - set process group

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

DESCRIPTION
     setpgrp sets 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 invoker is not the super-user, then the affected pro-
     cess must have the same effective user-id as the invoker or
     be a descendant of the invoking process.

RETURN VALUE
     setpgrp returns 0 when the operation is successful.  If the
     request failed, -1 is returned and the global variable errno
     indicates the reason.

ERRORS
     setpgrp will fail and the process group will not be altered
     if one of the following occur:

     [ESRCH]        The requested process does not exist.

     [EPERM]        The effective user ID of the requested pro-
                    cess is different from that of the caller and
                    the process is not a descendent of the cal-
                    ling process.

SEE ALSO
     getpgrp(2)





















                        Printed 11/19/92                   Page 1