Copyright (c) 1980 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)setpgid.2 6.2 (Berkeley) 02/19/91

C 4 setpgid, setpgrp - set process group setpgid(pid_t pid, pid_t pgrp);

setpgrp(pid_t pid, pid_t pgrp);

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.

Setpgid returns 0 when the operation was successful. If the request failed, -1 is returned and the global variable errno indicates the reason. Setpgid will fail and the process group will not be altered if one of the following occur:

15 [ESRCH] The requested process does not exist.

15 [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.

getpgrp(2) Setpgid conforms to IEEE Std 1003.1-1988 (``POSIX''). Setpgrp is identical to setpgid , and is retained for calling convention compatibility with historical versions of BSD.