manpagez: man pages & more
man getsid(2)
Home | html | info | man
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() func-
     tion call is derived from its usage in AT&T System V UNIX.

BSD                             August 19, 1997                            BSD

Mac OS X 10.9.1 - Generated Mon Jan 6 06:06:08 CST 2014
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.