tcgetattr()

Get the current terminal control settings

Synopsis:

#include <termios.h>

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

Arguments:

fildes: 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 fildes, 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 fildes argument is invalid.
ENOSYS: The resource manager associated with fildes doesn't support this call.
ENOTTY: The fildes 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