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 process 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 functionally 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.