The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

tcgetsid - get process group ID for session leader for controlling terminal

 SYNOPSIS



#include <termios.h>

pid_t tcgetsid(int fildes);

 DESCRIPTION

The tcgetsid() function obtains the process group ID of the session for which the terminal specified by fildes is the controlling terminal.

 RETURN VALUE

Upon successful completion, tcgetsid() returns the process group ID associated with the terminal. Otherwise, a value of (pid_t)-1 is returned and errno is set to indicate the error.

 ERRORS

The tcgetsid() function will fail if:
[EBADF]
The fildes argument is not a valid file descriptor.
[ENOTTY]
The calling process does not have a controlling terminal, or the file is not the controlling terminal.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

<termios.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]