setpgrp(2)setpgrp(2)NAMEsetpgrp - set process group ID
SYNOPSISDESCRIPTION
If the calling process is not already a session leader, sets the
process group ID of the calling process to the process ID of the call‐
ing process. If creates a new session, then the new session has no
controlling terminal.
The function has no effect when the calling process is a session
leader.
Security Restrictions
Some or all of the actions associated with this system call may require
privileges. See privileges(5) for more information.
RETURN VALUE
Upon successful completion, returns the new process group ID.
ERRORS
If fails, no changes occur and (see errno(2)) is set to one of the fol‐
lowing values:
The calling process is already a process group leader or
the process group ID of a process other than the
calling process matches the process ID of the
calling process.
The calling process does not have sufficient privileges.
SEE ALSOexec(2), fork(2), getpid(2), getsid(2), kill(2), setpgrp3(2), set‐
sid(2), privileges(5), <unistd.h>.
STANDARDS CONFORMANCEsetpgrp(2)