NAME    [Toc]    [Back]

     getsid - get process session

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     pid_t
     getsid(pid_t pid);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     getsid() will succeed unless:

     [EPERM]       The current process and the  process  pid  are
not in the same
                   session.

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

SEE ALSO    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

     The getsid() function call is derived from its usage in AT&T
System V
     UNIX,  and  is  mandated by X/Open Portability Guide Issue 4
(``XPG4'').

OpenBSD     3.6                         August      19,      1997