getsid(2) [opendarwin 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

     getsid() will succeed unless:

     [ESRCH]		if 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)							   System Calls 							 getsid(2)

NAME

       getsid - get process group ID of session leader

SYNOPSIS

       #include <unistd.h>

       pid_t getsid(pid_t pid);

DESCRIPTION

       The  getsid()  function	obtains the process group ID of the process that is the session leader of the process specified by pid.  If pid is
       (pid_t)0, it specifies the calling process.

RETURN VALUES

       Upon successful completion, getsid() returns the process group ID of the session leader of the specified  process.  Otherwise,  it  returns
       (pid_t)-1 and sets errno to indicate the error.

ERRORS

       The getsid() function will fail if:

       EPERM	       The  process  specified	by  pid  is  not in the same session as the calling process, and the implementation does not allow
		       access to the process group ID of the session leader of that process from the calling process.

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       exec(2), fork(2), getpid(2), getpgid(2), setpgid(2), setsid(2), attributes(5), standards(5)

SunOS 5.10							    22 Jan 1996 							 getsid(2)