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 11/26/99	   May 9, 1985				1