Index for Section 3

Alphabetical listing for T

Bottom of page

tcgetsid(3)
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)

Index for Section 3

Alphabetical listing for T

Top of page