Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

tcgetsid()

Get the process group ID of the session leader for a controlling terminal

Synopsis:

#include <unistd.h>

int tcgetsid( int filedes );

Arguments:

fildes
A file descriptor that's associated with the device whose ID you want to get.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

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

Returns:

The process group ID associated with the terminal, or -1 if an error occurs (errno is set).

Errors:

EACCES
The filedes argument isn't associated with a controlling terminal.
EBADF
The filedes argument isn't a valid file descriptor.
ENOTTY
The file associated with filedes isn't a terminal.

Classification:

POSIX 1003.1 XSI

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

tcsetsid()