tcgetattr()

Updated: April 19, 2023

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