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.1 (Berkeley) 05/09/85

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

int pid, pgrp;

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

Setpgrp returns when the operation was successful. If the request failed, -1 is returned and the global variable errno indicates the reason. Setpgrp 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)