tcgetsid(3) Library Functions Manual tcgetsid(3)
NAME
tcgetsid - Returns the session ID of the terminal
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <termios.h>
pid_t tcgetsid( pid_t fildes);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
tcgetsid(): XSH4.2
Refer to the standards(5) reference page for more information about industry standards and associated tags.
PARAMETERS
Specifies a terminal.
DESCRIPTION
The tcgetsid routine is a part of the general terminal interface. This routine obtains the session ID of the terminal as specified by the
fildes parameter.
RETURN VALUE
On success, the tcgetsid returns the session ID that is associated with the terminal specified. If the session ID of the terminal cannot
be obtained, a value of (pid_t)-1 is returned and errno is set to indicate error.
ERRORS
The tcgetsid() function sets errno to the specified values for the following conditions: The descriptor fildes is not associated with a
controlling terminal. The descriptor fildes is not valid. The file associated with fildes is not a terminal.
[Tru64 UNIX] The descriptor fildes is not associated with a character special device or the specified request does not apply to the
kind of object that fildes references.
RELATED INFORMATION
Standards: standards(5) delim off
tcgetsid(3)