NAME    [Toc]    [Back]

     getsid -- get process session

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

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 getsid() system call 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]

     The getsid() system call will succeed unless:

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

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

SEE ALSO    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

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


FreeBSD 5.2.1			August 19, 1997 		 FreeBSD 5.2.1