HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)
s
setpgrp(2) setpgrp(2)
NAME
setpgrp - set process group ID
SYNOPSIS
#include <unistd.h>
pid_t setpgrp(void);
DESCRIPTION
If the calling process is not already a session leader,
setpgrp() sets the process group ID of the calling
process to the process ID of the calling process. If
setpgrp() creates a new session, then the new session
has no controlling terminal.
The
setpgrp() function has no effect when the calling process is a session leader.
RETURN VALUE
Upon successful completion, setpgrp() returns the new process group ID.
ERRORS
If setpgrp() fails, no changes occur and errno (see errno(2)) is set to one of the following values:
[EPERM] The calling process is already a process group leader or the process group ID of a pro-
cess other than the calling process matches the process ID of the calling process.
WARNINGS
The semantics for setpgrp() changed in 10.10 (see setpgrp3(2) for compatibility to HP-UX 9.x).
SEE ALSO
exec(2), fork(2), getpid(2), getsid(2), kill(2), setsid(2), setpgrp3(2), <unistd.h>.
STANDARDS CONFORMANCE
setpgrp(): SVID2, SVID3, XPG2, XPG3, XPG4, XPG4.2
Section 2−−336 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005