unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.4BSD-Lite2)
Page:
Section:
Apropos / Subsearch:
optional field

SETPGID(2)                  BSD Programmer's Manual                 SETPGID(2)

NAME
     setpgid, setpgrp - set process group

SYNOPSIS
     #include <&lt;unistd.h>&gt;

     int
     setpgid(pid_tpid, pid_tpgrp);

     int
     setpgrp(pid_tpid, pid_tpgrp);

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 pro-
     cess.

     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 in-
     voking 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 different from
             that of the caller and the process is not a descendent 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 conven-
     tion compatibility with historical versions of BSD.

4th Berkeley Distribution        June 4, 1993                                1