4.3BSD-UWisc/man/cat2/setpgrp.2

Compare this file to the similar file:
Show the results in this format:



SETPGRP(2)          UNIX Programmer's Manual           SETPGRP(2)



NAME
     setpgrp - set process group

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

DESCRIPTION
     _S_e_t_p_g_r_p sets the process group of the specified process _p_i_d
     to the specified _p_g_r_p.  If _p_i_d 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
     _S_e_t_p_g_r_p returns when the operation was successful.  If the
     request failed, -1 is returned and the global variable _e_r_r_n_o
     indicates the reason.

ERRORS
     _S_e_t_p_g_r_p 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 12/27/86           May 9, 1985                          1