[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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.

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

See also:

errno, fpathconf(), tcsetattr(), termios

Chapter 7 of POSIX 1003.1


[Previous] [Contents] [Index] [Next]