getsid - get session ID
Contents
Description
getsid() returns the session ID of the process with process ID pid. If pid is 0, getsid() returns the
session ID of the calling process.
Errors
EPERM A process with process ID pid exists, but it is not in the same session as the calling process,
and the implementation considers this an error.
ESRCH No process with process ID pid was found.
History
POSIX.1-2001, SVr4. Linux 2.0.
Library
Standard C library (libc, -lc)
Name
getsid - get session ID
Notes
See credentials(7) for a description of sessions and session IDs.
Return Value
On success, a session ID is returned. On error, (pid_t)-1 is returned, and errno is set to indicate the
error.
See Also
getpgid(2), setsid(2), credentials(7)
Linux man-pages 6.9.1 2024-05-02 getsid(2)
Standards
POSIX.1-2008.
Synopsis
#include<unistd.h>pid_tgetsid(pid_tpid);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
getsid():
_XOPEN_SOURCE >= 500
|| /* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
Versions
Linux does not return EPERM.
