HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man2/!!!intro.2
________________________________________________________________
___ ___
s
setpgrp3(2) setpgrp3(2)
(TO BE OBSOLETED)
NAME
setpgrp3 - create session and set process group ID; for HP-UX 9.x compatibility
SYNOPSIS
#include <unistd.h>
pid_t setpgrp3(void);
DESCRIPTION
If the calling process is not a process group leader, setpgrp3() creates a new session. The calling pro-
cess becomes the session leader of this new session, it becomes the process group leader of a new process
group, and it has no controlling terminal. The process group ID of the calling process is set equal to the
process ID of the calling process. The calling process is the only process in the new process group, and the
only process in the new session.
setpgrp3() function is provided for HP-UX compatibility in future releases. setpgrp3() is function-
ally equivalent to setpgrp() as provided in HP-UX 9.x.
RETURN VALUE
Upon successful completion, setpgrp3() returns the value of the process group ID of the calling process.
Otherwise, it returns a value of −1
, and sets errno to indicate the error.
ERRORS
No errors are defined.
WARNINGS
Obsolescent Interfaces
setpgrp3() is to be obsoleted at a future date.
AUTHOR
setpgrp3() was developed by HP.
SEE ALSO
exec(2), exit(2), fork(2), getpid(2), kill(2), setpgid(2), setpgrp(2), setsid(2), signal(2), termio(7).
HP-UX Release 11i: December 2000 − 1 − Section 2−−315
___
___