getsid(2)getsid(2)NAMEgetsid - 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 ALSOexec(2), fork(2), getpid(2), setpgid(2), setsid(2)capabilities(4)dominance(5)
Page 1