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 ses-
          sion leader of this new session, the process group leader of
          a new process group, and does not have a controlling termi-
          nal.  The process group ID of the calling process is set to
          the process ID of the calling process.

     RETURN VALUE
          On successful completion, setsid returns the value of the
          process group ID of the calling process.

     ERRORS
          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).























     April, 1990                                                     1