tcsetattr()

Изменить настройки управления терминалом для устройства

Прототип:

#include <termios.h>
int tcsetattr( int fildes,
int optional_actions,
const struct termios *termios_p );

Аргументы:

fildes
Файловый дескриптор, связанный с терминальным устройством.
termios_p
Указатель на структуру struct termios, описывающую атрибуты, которые необходимо установить для этого терминала.

Библиотека:

libc

Описание:

Функция tcsetattr() устанавливает текущие настройки управления терминалом для открытого устройства, связанного с fildes, в значения, хранящиеся в структуре, на которую указывает termios_p.

Действие tcsetattr() зависит от значений в optional_actions:

TCSANOW
Изменение применяется немедленно.
TCSADRAIN
Изменения не применяются до тех пор, пока не будет передана вся записанная информация.
TCSAFLUSH
Изменения не применяются до тех пор, пока вся записанная информация не будет передана, в этот момент любая полученная, но непрочитанная информация также отклоняется.

Структура struct termios определена в <termios.h>. Для дополнительной информации, см. tcgetattr().

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EBADF
Некорректный аргумент fildes.
EINVAL
Некорректный аргумент action или один из членов termios_p некорректный.
ENOSYS
Менеджер ресурсов, связанный с fildes, не поддерживает этот вызов.
ENOTTY
Аргумент fildes не относится к терминальному устройству.

Примеры:

#include <stdlib.h>
#include <termios.h>
int raw( int fd )
{
struct termios termios_p;
if ( tcgetattr( fd, &termios_p ) )
return (-1);
termios_p.c_cc[VMIN] = 1;
termios_p.c_cc[VTIME] = 0;
termios_p.c_lflag &= ~(ECHO | ICANON | ISIG|
ECHOE | ECHOK | ECHONL);
termios_p.c_oflag &= ~(OPOST);
return (tcsetattr( fd, TCSADRAIN, &termios_p ));
}
int unraw( int fd )
{
struct termios termios_p;
if ( tcgetattr( fd, &termios_p ) )
return (-1);
termios_p.c_lflag |= (ECHO | ICANON | ISIG |
ECHOE | ECHOK | ECHONL);
termios_p.c_oflag |= (OPOST);
return (tcsetattr( fd, TCSADRAIN, &termios_p ));
}
int main( void )
{
raw( 0 );
/* Stdin is now "raw" */
unraw( 0 );
return (EXIT_SUCCESS);
}

Классификация:

POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

errno, ioctl(), select(), tcgetattr(), struct termios




Предыдущий раздел: Описание API системной библиотеки