TCGETSID
Section: Linux Programmer's Manual (3)
Updated: 2010-09-10
Index
Return to Main Contents
NAME
tcgetsid - get session ID
SYNOPSIS
#define _XOPEN_SOURCE 500 /* See feature_test_macros(7) */
#include <termios.h>
pid_t tcgetsid(int fd);
DESCRIPTION
The function
tcgetsid()
returns the session ID of the current session that has the
terminal associated to
fd
as controlling terminal.
This terminal must be the controlling terminal of the calling process.
RETURN VALUE
When
fd
refers to the controlling terminal of our session,
the function
tcgetsid()
will return the session ID of this session.
Otherwise, -1 is returned, and
errno
is set appropriately.
ERRORS
- EBADF
-
fd
is not a valid file descriptor.
- ENOTTY
-
The calling process does not have a controlling terminal, or
it has one but it is not described by
fd.
VERSIONS
tcgetsid()
is provided in glibc since version 2.1.
CONFORMING TO
POSIX.1-2001.
NOTES
This function is implemented via the
TIOCGSID
ioctl(2),
present
since Linux 2.1.71.
SEE ALSO
getsid(2)
COLOPHON
This page is part of release 3.27 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/.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- VERSIONS
-
- CONFORMING TO
-
- NOTES
-
- SEE ALSO
-
- COLOPHON
-
This document was created by
man2html,
using the manual pages.
Time: 19:49:25 GMT, April 27, 2011