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:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | Yes |
| Thread | Yes |