getsid.2 (2010 09)

g
getsid(2) getsid(2)
NAME
getsid() - get session ID
SYNOPSIS
#include <sys/types.h>
pid_t getsid (pid_t pid);
DESCRIPTION
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.
Security Restrictions
The actions associated with this system call are subject to compartmental restrictions. See compart-
ments(5) for more information about compartmentalization on systems that support that feature.
Compartmental restrictions can be overridden if the process possesses the
COMMALLOWED privilege
(PRIV_COMMALLOWED). Processes owned by the superuser may not have this privilege. Processes
owned by any user may have this privilege, depending on system configuration.
See privileges (5) for more information about privileged access on systems that support fine-grained
privileges.
RETURN VALUE
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
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
exec(2), fork(2), getpgid(2), getpid(2), setpgid(2), setsid(2), tcgetsid(3C).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1