tcgetsize()

Updated: April 19, 2023

Get the size of a character device

Synopsis:

#include <termios.h>

int tcgetsize( int filedes,
               int* prows,
               int* pcols );

Arguments:

filedes
A file descriptor that's associated with the device whose size you want to get.
prows, pcols
NULL, or pointers to locations where the function can store the number of rows and columns.

Library:

libc

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

Description:

The tcgetsize() function gets the size of the character device associated with filedes and stores the number of rows and columns in prows and pcols if they're not NULL.

Returns:

0
Success.
-1
An error occurred (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:

QNX Neutrino

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