getsid(2)                        UNIX System V                        getsid(2)


NAME
      getsid - get session ID

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

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

RETURN VALUE
      Upon successful completion, the function getsid returns the session ID of
      the specified process; otherwise, it returns a value of (pidt)-1 and
      sets errno to indicate an error.

ERRORS
      Under the following conditions, the function getsid fails and sets errno
      to:

      EPERM     if 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     if there is no process with a process ID equal to pid.

SEE ALSO
      exec(2), fork(2), getpid(2), setpgid(2), setsid(2)
























10/89                                                                    Page 1