setsid(2P)                                             setsid(2P)



NAME
     setsid - create session and set process group ID

SYNOPSIS
     #include <sys/types.h>

     pid_t setsid()

DESCRIPTION
     setsid creates a new session if the calling process is not a
     process group leader.  The calling process becomes the
     session leader of this new session, the process group leader
     of a new process group, and does not have a controlling
     terminal.  The process group ID of the calling process is
     set to the process ID of the calling process.

STATUS MESSAGES AND VALUES
     On successful completion, setsid returns the value of the
     process group ID of the calling process.

     If any of the following conditions occur, setsid returns -1
     and sets errno to the corresponding value:

     EPERM
          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.

SEE ALSO
     exec(2), _exit(2), fork(2), getpid(2), kill(2), setpgid(2P),
     sigaction(3P)























January 1992                                                    1