NAME

tcgetsid − returns the session ID of the terminal

SYNOPSIS

#include <termios.h>
pid_t tcgetsid(
        pid_t fildes );

LIBRARY

Standard C Library (libc.so, libc.a)

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

fildes
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. 

ERRORS

The tcgetsid() function sets errno to the specified values for the following conditions:

[EACCES]
The descriptor fildes is not associated with a controlling terminal. 

[EBADF]
The descriptor fildes is not valid. 

[ENOTTY]
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. 

RETURN VALUE

On success, 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. 

SEE ALSO

Standards: standards(5)