setsid(2)setsid(2)NAMEsetsid - create session and set process group ID
SYNOPSISDESCRIPTION
If the calling process is not a process group leader, 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 call‐
ing 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.
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 value of the new process group
ID of the calling process. Otherwise, it returns a value of and sets
to indicate the error.
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.
AUTHOR
was developed by HP and AT&T.
SEE ALSOexec(2), exit(2), fork(2), getpid(2), kill(2), setpgid(2), setpgrp(2),
setpgrp3(2), signal(2), privileges(5), termio(7).
STANDARDS CONFORMANCEsetsid(2)