SETPGID(2) MachTen Programmer’s Manual SETPGID(2)

NAME
setpgid, setpgrp - set process group

SYNOPSIS
#include <unistd.h>

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 UNIX.

4th Berkeley Distribution June 4, 1993 1