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
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.
@(#)setpgid.2 6.2 (Berkeley) 02/19/91
SETPGRP 2 ""
C 4 NAME
setpgid, setpgrp - set process group
SYNOPSIS
setpgid(pid_t pid, pid_t pgrp);
setpgrp(pid_t pid, pid_t pgrp);
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 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.
"RETURN VALUE
Setpgid returns 0 when the operation was successful.
If the request failed, -1 is returned and the global variable
errno indicates the reason.
ERRORS
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.
"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 convention compatibility with historical
versions of BSD.