getsid(2)							     getsid(2)

NAME    [Toc]    [Back]

     getsid - get session ID

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>

     pid_t getsid(pid_t	pid<b>);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     exec(2), fork(2), getpid(2), setpgid(2), setsid(2)	capabilities(4)
     dominance(5)


									PPPPaaaaggggeeee 1111