getsid(2)                                                            getsid(2)


NAME
     getsid - get session ID

SYNOPSIS
     #include <sys/types.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 VALUE
     Upon successful completion, the function getsid returns the session ID of
     the specified process; otherwise, it returns a value of (pid_t)-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, the implementation does
               not allow access to the session ID of that process from the
               calling process.  Under IRIX, access to the session ID of that
               process is always allowed to the calling process.

     EACCES    In the Trusted IRIX environment, the MAC label of the current
               process does not dominate and is not equal to the MAC label of
               the process pid , and the current process does not have the
               CAP_MAC_READ capability.

     EINVAL    The pid is out of range or is not an invalid argument.

     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) capabilities(4)
     dominance(5)


                                                                        Page 1