getsid(2) [mojave man page]

GETSID(2)						      BSD System Calls Manual							 GETSID(2)

NAME

     getsid -- get process session

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <unistd.h>

     pid_t
     getsid(pid_t pid);

DESCRIPTION

     The session ID of the process identified by pid is returned by getsid().  If pid is zero, getsid() returns the session ID of the current
     process.

RETURN VALUES

     Upon successful completion, the function getsid() returns the session ID of the specified process; otherwise, it returns a value of -1 and
     sets errno to indicate an error.

ERRORS

     The getsid() system call will fail if:

     [ESRCH]		There is no process with a process ID equal to pid.

     Note that an implementation may restrict this function call to processes within the same session ID as the calling process.

SEE ALSO

     getpgid(2), getpgrp(2), setpgid(2), setsid(2), termios(4)

HISTORY

     The getsid() function call appeared in FreeBSD 3.0.  The getsid() function call is derived from its usage in AT&T System V UNIX.

BSD
								  August 19, 1997							       BSD

GETSID(2)						     Linux Programmer's Manual							 GETSID(2)

NAME

       getsid - get session ID

SYNOPSIS

       #include <unistd.h>

       pid_t getsid(pid_t pid);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       getsid(): _XOPEN_SOURCE >= 500

DESCRIPTION

       getsid(0)  returns the session ID of the calling process.  getsid(p) returns the session ID of the process with process ID p.  (The session
       ID of a process is the process group ID of the session leader.)

RETURN VALUE

       On success, a session ID is returned.  On error, (pid_t) -1 will be returned, and errno is set appropriately.

ERRORS

       EPERM  A process with process ID p 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 p was found.

VERSIONS

       This system call is available on Linux since version 2.0.

CONFORMING TO

       SVr4, POSIX.1-2001.

NOTES

       Linux does not return EPERM.

SEE ALSO

       getpgid(2), setsid(2), credentials(7)

COLOPHON

       This  page is part of release 3.25 of the Linux man-pages project.  A description of the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

Linux								    2008-12-05								 GETSID(2)