Content-type: text/html Man page of tcgetsid

tcgetsid

Section: C Library Functions (3)
Index Return to Main Contents
 

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():  XPG4-UNIX

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. [XPG4-UNIX]  The file associated with fildes is not a terminal.

[Digital]  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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUE
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:44 GMT, October 02, 2010