setpgrp2(2)                      DG/UX 5.4.2                     setpgrp2(2)


NAME
       setpgrp2 - set process-group-id

SYNOPSIS
       #include <sys/types.h>

       int  setpgrp2 (pid, pgrp)
       pidt  pid;
       gidt  pgrp;

   where:
       pid       The process-id of the process whose process-group-id is to
                 be changed.  A value of zero denotes the calling process,
                 not pid 0.

       pgrp      The value to which the target process's process-group-id is
                 to be set

DESCRIPTION
       If the access control requirements described below are met, setpgrp2
       sets the process-group-id of the process specified by pid to the
       value specified by pgrp.  The value of pgrp is not required to be the
       process-id of an existing process; hence a process group with no
       group leader can be established.

ACCESS CONTROL
       The access control requirements of setpgrp2 can be met in one of
       three ways:  1) the caller has effective-user-id of superuser, or 2)
       the target process is a descendant of the caller in the process tree,
       or 3) the target process has the same effective-user-id as the
       caller.

RETURN VALUE
       0      Successful completion.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       ESRCH     The process specified by pid does not exist.

       EPERM     None of the three conditions described in the ACCESS
                 CONTROL section above is met.

SEE ALSO
       getpgrp(2), getpgrp2(2), setpgrp(2).

STANDARDS
       When using m88kbcs as the Software Development Environment target,
       the setpgrp2 function will be a restricted emulation of Berkeley
       semantics.  This emulation only allows a process to join a process
       group already in use inside its session or to create a new process
       group whose process group ID is equal to its process ID.



Licensed material--property of copyright holder(s)                         1