Index for Section 3

Alphabetical listing for T

Bottom of page

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

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:

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

RELATED INFORMATION
  Standards: standards(5)

Index for Section 3

Alphabetical listing for T

Top of page