SETPGID(2)                       System Calls                       SETPGID(2)

NAME

       setpgid, setpgrp - set process group

SYNOPSIS

       #include <unistd.h>

       int setpgid (pid_t pid, pid_t pgrp);
       int setpgrp (pid_t pid, pid_t pgrp);

DESCRIPTION

       Setpgid  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

       Setpgid  returns  0  when the operation was successful.  If the request
       failed, -1 is returned and the global variable errno indicates the rea‐
       son.

ERRORS

       Setpgid 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 differ‐
                     ent from that of the caller and the process is not a  de‐
                     scendent of the calling process.

SEE ALSO

       getpgrp(2)

STANDARDS

       Setpgid conforms to IEEE Std 1003.1-1988 (POSIX).

COMPATIBILITY

       Setpgrp is identical to setpgid, and is retained for calling convention
       compatibility with historical versions of BSD.



GNO                             16 January 1997                     SETPGID(2)