SETPGRP(2)                           BSD                            SETPGRP(2)



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 0, then the call applies to the current
     process.

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

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

     [ESRCH]   The requested process does not exist.

     [EPERM]   The effective user ID of the requested process is different
               from that of the caller and the process is not a descendent of
               the calling process.

SEE ALSO
     getpgrp(2)

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