tcgetattr()

Get the current terminal control settings

Synopsis:

#include <termios.h>

int tcgetattr( int filedes,
               struct termios *termios_p );

Arguments:

filedes: The file descriptor associated with the terminal device.
termios_p: A pointer to a termios structure in which tcgetattr() can store the terminal's control attributes.

Library:

libc

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

Description:

The tcgetattr() function gets the current terminal control settings for the opened device indicated by filedes, and stores the results in the structure pointed to by termios_p.

For more information, see chapter 7 of POSIX 1003.1

Returns:

0: Success.
-1: An error occurred; errno is set.

Errors:

EBADF: The filedes argument is invalid.
ENOSYS: The resource manager associated with filedes doesn't support this call.
ENOTTY: The filedes argument doesn't refer to a terminal device.

Examples:

See tcsetattr().

Classification:

POSIX 1003.1

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