Click this button to go to the index for this section.

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

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