tcgetsize()

Get the size of a character device

Synopsis:

#include <termios.h>

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

Arguments:

fildes: 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 fildes 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 fildes argument isn't associated with a controlling terminal.
EBADF: The fildes argument isn't a valid file descriptor.
ENOTTY: The file associated with fildes isn't a terminal.

Classification:

QNX Neutrino

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