getsid(2)                                                         getsid(2)




 NAME    [Toc]    [Back]
      getsid() - get session ID

 SYNOPSIS    [Toc]    [Back]
      #include <sys/types.h>

      pid_t getsid (pid_t pid);

 DESCRIPTION    [Toc]    [Back]
      The getsid() function returns the session ID of the specified process.
      If pid is 0, the call applies to the current process.  For this to be
      allowed, the current process and the referenced process must be in the
      same session.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, getsid() returns the session ID of the
      specified process.  Otherwise, it returns a value of -l and sets errno
      to indicate the error.

 ERRORS    [Toc]    [Back]
      If the getsid() function fails, it sets errno (see errno(2)) to one of
      the following values:

           [EPERM]        The current process and the specified process are
                          not in the same session.

           [ESRCH]        No process can be found corresponding to that
                          specified by pid.

 SEE ALSO    [Toc]    [Back]
      exec(2), fork(2), getpgid(2), getpid(2), setpgid(2), setsid(2),
      tcgetsid(3C).


 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003