SETPGID(2) BSD Programmer's Manual SETPGID(2)
setpgid, setpgrp - set process group
#include <unistd.h> int setpgid(pid_t pid, pid_t pgrp); int 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 pro- cess. If the invoker is not the superuser, then the affected process must have the same effective user ID as the invoker or be a descendant of the in- voking process.
setpgid() returns 0 when the operation was successful. If the request failed, -1 is returned and the global variable errno indicates the rea- son.
setpgid() will fail and the process group will not be altered if: [EACCES] The value of the pid argument matches the process ID of a child process of the calling process, and the child process has successfully executed one of the exec functions. [EINVAL] The value of the pgrp argument is less than zero. [EPERM] The effective user ID of the requested process is different from that of the caller and the process is not a descendant of the calling process. [ESRCH] The value of the pid argument does not match the process ID of the calling process or of a child process of the calling process.
setpgrp() is identical to setpgid(), and is retained for calling conven- tion compatibility with historical versions of BSD. The setpgid() function conforms to IEEE Std 1003.1-1988 ("POSIX"). MirOS BSD #10-current June 4, 1993 1
Generated on 2013-10-31 22:57:03 by $MirOS: src/scripts/roff2htm,v 1.77 2013/01/01 20:49:09 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2013 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.