getsid(2)                                                  getsid(2)


       NAME
             getsid - get session ID

       SYNOPSIS
             #include <sys/types.h>
             #include <unistd.h>
             pid_t getsid(pid_t pid);

       DESCRIPTION
             The function getsid returns the session ID of the process
             whose process ID is equal to pid.  If pid is equal to
             (pid_t)0, getsid returns the session ID of the calling
             process.

          Return Values
             On success, getsid returns the session ID of the specified
             process.  On failure, getsid returns (pid_t)-1 and sets errno
             to identify the error.

          Errors
             In the following conditions, getsid fails and sets errno to:

             EPERM     The process whose process ID is equal to pid is not
                       in the same session as the calling process, and the
                       implementation does not allow access to the session
                       ID of that process from the calling process.

             ESRCH     There is no process with a process ID equal to pid.

       REFERENCES
             exec(2), fork(2), getpid(2), setpgid(2), setsid(2)

       NOTICES
          Considerations for Threads Programming
             These ID numbers are attributes of the containing process and
             are shared by sibling threads.












                           Copyright 1994 Novell, Inc.               Page 1