NAME    [Toc]    [Back]

     setpgid, setpgrp -- set process group

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     int
     setpgid(pid_t pid, pid_t pgrp);

     int
     setpgrp(pid_t pid, pid_t pgrp);

DESCRIPTION    [Toc]    [Back]

     The setpgid() system call 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 process must have
     the same effective user-id as the invoker or be a descendant of the
     invoking process.

RETURN VALUES    [Toc]    [Back]

     The setpgid() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

ERRORS    [Toc]    [Back]

     The setpgid() system call will fail and the process group will not be
     altered if:

     [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    [Toc]    [Back]

     getpgrp(2)

STANDARDS    [Toc]    [Back]

     The setpgid() system call is expected to conform to ISO/IEC 9945-1:1990
     (``POSIX.1'').

COMPATIBILITY    [Toc]    [Back]

     The setpgrp() system call is identical to setpgid(), and is retained for
     calling convention compatibility with historical versions of BSD.


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1