tcgetsid(3c) hpux man page | unix.com

tcgetsid(3C)															      tcgetsid(3C)

NAME
       tcgetsid() - get terminal session ID

SYNOPSIS
DESCRIPTION
       The  function  returns the value of the session ID of the foreground process associated with the terminal referenced by fildes.	is allowed
       from a process that is a member of a background process group (see termio(7)).

RETURN VALUE
       Upon successful completion, returns the value of the session ID of the foreground  process  associated  with  the  terminal  referenced	by
       fildes.	Otherwise, returns a value of and sets to indicate the error.

ERRORS
       If the function fails, it sets (see errno(2)) to one of the following values:

	      [EACCES]	     The  file	associated with fildes is the controlling terminal of the calling process; however, there is no foreground
			     process group defined for the controlling terminal.

	      [EBADF]	     fildes is not a valid file descriptor.

	      [ENOTTY]	     The file associated with fildes is not the controlling terminal or the calling process does not  have  a  controlling
			     terminal.

SEE ALSO
       getsid(2), setsid(2), tcgetpgrp(3C), thread_safety(5).

																      tcgetsid(3C)