NAME    [Toc]    [Back]

       tcgetsid - returns the session ID of the terminal

SYNOPSIS    [Toc]    [Back]

       #include <termios.h>

       pid_t tcgetsid(
               pid_t fildes );

LIBRARY    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Specifies a terminal.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       Standards: standards(5)



                                                      tcgetsid(3)