Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
QNX Documentation Library
tcgetattr

tcgetattr

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

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