- bookworm 4.18.1-1
- bookworm-backports 4.20.0-1~bpo12+1
- testing 4.20.0-1
- unstable 4.20.0-1
termios(3) | Library Functions Manual | termios(3) |
ИМЯ¶
termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed, cfsetspeed - возвращает и задаёт атрибуты терминала, управляет линией, возвращает и задаёт скорость передачи
LIBRARY¶
Standard C library (libc, -lc)
СИНТАКСИС¶
#include <termios.h> #include <unistd.h>
int tcgetattr(int fd, struct termios *termios_p); int tcsetattr(int fd, int optional_actions, const struct termios *termios_p);
int tcsendbreak(int fd, int duration); int tcdrain(int fd); int tcflush(int fd, int queue_selector); int tcflow(int fd, int action);
void cfmakeraw(struct termios *termios_p);
speed_t cfgetispeed(const struct termios *termios_p); speed_t cfgetospeed(const struct termios *termios_p);
int cfsetispeed(struct termios *termios_p, speed_t speed); int cfsetospeed(struct termios *termios_p, speed_t speed); int cfsetspeed(struct termios *termios_p, speed_t speed);
cfsetspeed(), cfmakeraw():
Начиная с glibc 2.19:
_DEFAULT_SOURCE
В версии glibc 2.19 и более ранних:
_BSD_SOURCE
ОПИСАНИЕ¶
Функции termios описывают общий интерфейс терминала, который предоставляет управление асинхронными портами связи.
Структура termios¶
Множество описанных здесь функций имеют аргумент termios_p, который является указателем на структуру termios. В этой структуре есть, по крайней мере, следующие поля:
tcflag_t c_iflag; /* режимы ввода */ tcflag_t c_oflag; /* режимы вывода */ tcflag_t c_cflag; /* режимы управления */ tcflag_t c_lflag; /* локальные режимы */ cc_t c_cc[NCCS]; /* специальные символы */
Значения этих полей описаны далее. Для первых четырёх полей битовых масок определения некоторых флагов доступны только, если определён специальный макрос тестирования свойств (смотрите feature_test_macros(7)), как указано в квадратных скобках («[]»).
В описаниях ниже приписка «нет в POSIX» означает, что значение не описано в POSIX.1-2001, а «XSI» — что значение описано в POSIX.1-2001 как часть расширения XSI.
Константы флага c_iflag:
- IGNBRK
- Игнорировать состояние BREAK в вводе.
- BRKINT
- If IGNBRK is set, a BREAK is ignored. If it is not set but BRKINT is set, then a BREAK causes the input and output queues to be flushed, and if the terminal is the controlling terminal of a foreground process group, it will cause a SIGINT to be sent to this foreground process group. When neither IGNBRK nor BRKINT are set, a BREAK reads as a null byte ('\0'), except when PARMRK is set, in which case it reads as the sequence \377 \0 \0.
- IGNPAR
- Игнорировать ошибки кадра и чётности.
- PARMRK
- Если этот бит установлен, то входящие байты с ошибками чётности или кадра помечаются при передаче в программу. Этот бит значим, только когда установлен бит INPCK и не установлен бит IGNPAR. Байты с ошибками помечаются двумя предваряющими их байтами \377 и \0. То есть программа, на самом деле, читает три байта при получении одного байта с ошибками с терминала. Если корректный байт имеет значение \377 и бит ISTRIP (смотрите далее) не установлен, то программа может ошибочно посчитать его как помечающий ошибки чётности. Поэтому в этом случае корректный байт \377 передаётся программе как два байта, \377 \377.
- Если IGNPAR или PARMRK не указаны, то символ с ошибкой чётности или кадра считывается как \0.
- INPCK
- Включить проверку чётности ввода.
- ISTRIP
- Удалять восьмой бит.
- INLCR
- Преобразовывать NL в CR в вводе.
- IGNCR
- Игнорировать возврат каретки в вводе.
- ICRNL
- Преобразовывать возврат каретки в символ новой строки в вводе (если не указан IGNCR).
- IUCLC
- (нет в POSIX) Переводить заглавные буквы в прописные в вводе.
- IXON
- Включить управление потоком XON/XOFF в выводе.
- IXANY
- (XSI) Набор любого символа запускает остановленный вывод (по умолчанию только символ START заново запускает вывод).
- IXOFF
- Включить управление потоком XON/XOFF в вводе.
- IMAXBEL
- (нет в POSIX) Выдавать звуковой сигнал, когда очередь ввода переполняется. В Linux не реализован этот бит и его действие выполняется всегда.
- IUTF8 (начиная с Linux 2.6.4)
- (нет в POSIX) Ввод в UTF8; это позволяет символу стирания (character-erase) правильно работать в режиме предварительной обработки (cooked mode).
Константы флага c_oflag:
- OPOST
- Включить обработку вывода, определяемую реализацией.
- OLCUC
- (нет в POSIX) Переводить прописные буквы в заглавные в выводе.
- ONLCR
- (XSI) Преобразовывать NL в CR-NL в выводе.
- OCRNL
- Преобразовывать CR в NL в выводе.
- ONOCR
- Не выводить CR в столбец 0.
- ONLRET
- The NL character is assumed to do the carriage-return function; the kernel's idea of the current column is set to 0 after both NL and CR.
- OFILL
- Посылать символы заполнения для задержки, а не использовать временную задержку.
- OFDEL
- Fill character is ASCII DEL (0177). If unset, fill character is ASCII NUL ('\0'). (Not implemented on Linux.)
- NLDLY
- Маска задержки новой строки. Значениями могут быть NL0 и NL1 [требуется _BSD_SOURCE, _SVID_SOURCE или _XOPEN_SOURCE].
- CRDLY
- Маска задержки перевода каретки. Значениями могут быть CR0, CR1, CR2 или CR3 [требуется _BSD_SOURCE, _SVID_SOURCE или _XOPEN_SOURCE].
- TABDLY
- Маска задержки горизонтальной табуляции. Значениями могут быть TAB0, TAB1, TAB2, TAB3 (или XTABS, но смотрите раздел BUGS). Значение TAB3, то есть, XTABS, раскрывает табуляцию в пробелы (один символ табуляции — восемь столбцов) [требуется _BSD_SOURCE, _SVID_SOURCE или _XOPEN_SOURCE].
- BSDLY
- Маска задержки символа забоя. Значениями могут быть BS0 или BS1 (никогда не была реализована) [требуется _BSD_SOURCE, _SVID_SOURCE или _XOPEN_SOURCE].
- VTDLY
- Маска задержки вертикальной табуляции. Значениями могут быть VT0 или VT1.
- FFDLY
- Маска задержки прокрутки страницы. Значениями могут быть FF0 или FF1 [требуется _BSD_SOURCE, _SVID_SOURCE или _XOPEN_SOURCE].
Константы флага c_cflag:
- CBAUD
- (нет в POSIX) Маска скорости в бодах (4+1 бита) [требуется _BSD_SOURCE или _SVID_SOURCE].
- CBAUDEX
- (нет в POSIX) Дополнительная маска скорости в бодах (1 бит), включена в CBAUD [требуется _BSD_SOURCE или _SVID_SOURCE].
- В стандарте POSIX указано, что скорость в бодах хранится в структуре termios без указания её точного местонахождения, и для работы к ней используются cfgetispeed() и cgfsetispeed(). В некоторых системах используются биты, выбираемые CBAUD в c_cflag, в других используются отдельные поля, например sg_ispeed и sg_ospeed.
- CSIZE
- Маска размера символа. Значениями могут быть CS5, CS6, CS7 или CS8.
- CSTOPB
- Использовать два стоповых бита вместо одного.
- CREAD
- Включить приёмник.
- PARENB
- Запустить генерацию чётности при выводе и проверку чётности на вводе.
- PARODD
- Если указано, то при вводе и выводе используется отрицательная чётность, в противном случае используется положительная чётность.
- HUPCL
- Выключить управляющие линии модема после того, как последний процесс прекратит использование устройства (повесит трубку).
- CLOCAL
- Игнорировать управляющие линии модема.
- LOBLK
- (нет в POSIX) Блокировать вывод из не текущего уровня оболочки (для использования в shl (shell layers), не реализовано в Linux).
- CIBAUD
- (not in POSIX) Mask for input speeds. The values for the CIBAUD bits are the same as the values for the CBAUD bits, shifted left IBSHIFT bits. [requires _BSD_SOURCE or _SVID_SOURCE] (Not implemented in glibc, supported on Linux via TCGET* and TCSET* ioctls; see ioctl_tty(2))
- CMSPAR
- (нет в POSIX) Использовать «липкую» (есть/нет) чётность (поддерживается в некоторых последовательных устройствах): если задан PARODD, то бит чётности всегда 1; если PARODD не задан, то бит чётности всегда 0 [требуется _BSD_SOURCE или _SVID_SOURCE].
- CRTSCTS
- (нет в POSIX) Разрешить (аппаратное) управление потоком данных RTS/CTS [требуется _BSD_SOURCE или _SVID_SOURCE].
Константы флага c_lflag:
- ISIG
- При получении символов INTR, QUIT, SUSP или DSUSP генерировать соответствующий сигнал.
- ICANON
- Включить канонический режим (описан далее).
- XCASE
- (нет в POSIX; не поддерживается в Linux) Если также указан ICANON, то терминал работает только с символами в верхнем регистре. Ввод преобразуется в символы нижнего регистра, кроме символов, предваряемых \. При выводе предваряемые \ символы в верхнем регистре и символы в нижнем регистре преобразуются в символы верхнего регистра [requires _BSD_SOURCE, _SVID_SOURCE или _XOPEN_SOURCE].
- ECHO
- Отображать вводимые символы.
- ECHOE
- Если также указан ICANON, то символ ERASE стирает предыдущий введённый символ, а WERASE стирает предыдущее слово.
- ECHOK
- Если также указан ICANON, то символ KILL стирает текущую строку.
- ECHONL
- Если также указан ICANON, то символ NL отображается, даже если не указан ECHO.
- ECHOCTL
- (not in POSIX) If ECHO is also set, terminal special characters other than TAB, NL, START, and STOP are echoed as ^X, where X is the character with ASCII code 0x40 greater than the special character. For example, character 0x08 (BS) is echoed as ^H. [requires _BSD_SOURCE or _SVID_SOURCE]
- ECHOPRT
- (нет в POSIX) Если также указаны ICANON и IECHO, то символы печатаются по мере того, как они стираются [требуется _BSD_SOURCE или _SVID_SOURCE].
- ECHOKE
- (нет в POSIX) Если также указан ICANON, то KILL выводится стиранием каждого символа в строке, как задано ECHOE и ECHOPRT [требуется _BSD_SOURCE или _SVID_SOURCE].
- DEFECHO
- (нет в POSIX) Выводить (echo) только в момент чтения процессом (не реализовано в Linux).
- FLUSHO
- (нет в POSIX; не поддерживается в Linux) Выводимые данные сбрасываются (flushed). Этот флаг переключается с помощью набираемого символа DISCARD [требуется _BSD_SOURCE или _SVID_SOURCE].
- NOFLSH
- Отключить сброс (flushing) очередей ввода и вывода во время генерации сигналов из-за символов INT, QUIT и SUSP.
- TOSTOP
- Послать сигнал SIGTTOU группе процессов фонового процесса, который пытается писать на управляющий терминал.
- PENDIN
- (нет в POSIX; не поддерживается в Linux) Все символы в очереди ввода повторно печатаются, когда читается последующий символ (это используется в bash(1) для перехвата набираемого) [требуется _BSD_SOURCE или _SVID_SOURCE].
- IEXTEN
- Включить обработку ввода, определяемую реализацией. Этот флаг, как и ICANON, должен быть включён для обработки специальных символов EOL2, LNEXT, REPRINT, WERASE, а также для того, чтобы работал флаг IUCLC.
Массивом c_cc определяются специальные символы терминала. Символьные индексы (начальные значения) и их смысл:
- VDISCARD
- (нет в POSIX; не поддерживается в Linux; 017, SI, Ctrl-O) Переключатель: включить/выключить отбрасывание ожидающего вывода. Распознаётся, если указан IEXTEN и, в этом случае, не передаётся как ввод.
- VDSUSP
- (нет в POSIX; не поддерживается в Linux; 031, EM, Ctrl-Y) Символ отложенного приостанова (DSUSP). Посылает сигнал SIGTSTP при считывании символа программой пользователя. Распознаётся, если указаны IEXTEN и ISIG, и система поддерживает управление заданиями. В этом случае не передаётся как ввод.
- VEOF
- (004, EOT, Ctrl-D) Символ конца файла (EOF). Этот символ заставляет переслать ждущий обработки буфер tty ожидающей программе пользователя без ожидания конца строки. Если это первый символ в строке, то read(2) вернёт программе 0, что означает конец файла. Распознаётся, если указан ICANON, и, в этом случае, не передаётся как ввод.
- VEOL
- (0, NUL) Дополнительный символ конца строки (EOL). Распознаётся, если указан ICANON.
- VEOL2
- (нет в POSIX; 0, NUL) Ещё один символ конца строки (EOL2). Распознаётся, если указан ICANON.
- VERASE
- (0177, DEL, rubout, или 010, BS, Ctrl-H, а также #) Символ забоя (ERASE). Стирает предыдущий ещё не стёртый символ, но не стирает за EOF или началом строки. Распознаётся, если указан ICANON, и, в этом случае, не передаётся как ввод.
- VINTR
- (003, ETX, Ctrl-C, а также 0177, DEL, rubout) Символ прерывания (INTR). Посылает сигнал SIGINT. Распознаётся, если указан ISIG, и, в этом случае, не передаётся как ввод.
- VKILL
- (025, NAK, Ctrl-U, или Ctrl-X, а также @) Символ уничтожения (KILL). Стирает ввод начиная с последнего EOF или начала строки. Распознаётся, если указан ICANON, и, в этом случае, не передаётся как ввод.
- VLNEXT
- (нет в POSIX; 026, SYN, Ctrl-V) Следующий символ — литера (LNEXT). Экранирует следующий введённый символ, отменяя его возможное специальное значение. Распознаётся, если указан IEXTEN и, в этом случае, не передаётся как ввод.
- VMIN
- Минимальное количество символов для неканонического чтения (MIN).
- VQUIT
- (034, FS, Ctrl-\) Символ завершения (QUIT). Посылает сигнал SIGQUIT. Распознаётся, если указан ISIG, и, в этом случае, не передаётся как ввод.
- VREPRINT
- (нет в POSIX; 022, DC2, Ctrl-R) Вывести заново непрочитанные символы (REPRINT). Распознаётся, если указан ICANON и IEXTEN и, в этом случае, не передаётся как ввод.
- VSTART
- (021, DC1, Ctrl-Q) Символ запуска (START). Перезапускает вывод, остановленный символом останова. Распознаётся, если указан IXON и, в этом случае, не передаётся как ввод.
- VSTATUS
- (нет в POSIX; не поддерживается в Linux; запрос состояния: 024, DC4, Ctrl-T). Символ состояния (STATUS). Выводит информацию о состоянии на терминал, включая состояние активного (foreground) процесса и количество потраченного времени ЦП. Также посылает сигнал SIGINFO (не поддерживается в Linux) активной группе процессов.
- VSTOP
- (023, DC3, Ctrl-S) Символ останова (STOP). Приостанавливает вывод до появления символа запуска. Распознаётся, если указан IXON и, в этом случае, не передаётся как ввод.
- VSUSP
- (032, SUB, Ctrl-Z) Символ приостанова (SUSP). Посылает сигнал SIGTSTP. Распознаётся, если указан ISIG и, в этом случае, не передаётся как ввод.
- VSWTCH
- (нет в POSIX; не поддерживается в Linux; 0, NUL) Символ переключения (SWTCH). Используется в System V для переключения оболочек в слоях оболочек, предшественник механизма управления задачами в оболочке.
- VTIME
- Время ожидания в децисекундах для неканонического чтения (TIME).
- VWERASE
- (нет в POSIX; 027, ETB, Ctrl-W) Стирание слова (WERASE). Распознаётся, если указан ICANON и IEXTEN и, в этом случае, не передаётся как ввод.
Отдельные специальные терминальные символы могут быть выключены указанием значения _POSIX_VDISABLE в соответствующем элементе c_cc.
Все значения индексов этих символов различны, за исключением VTIME, VMIN, которые могут иметь те же значения, что и VEOL, VEOF, соответственно. В неканоническом режиме значения специальных символов используются как значения времени ожидания. Предназначение VMIN и VTIME смотрите в описании неканонического режима далее.
Получение и изменение настроек терминала¶
Функция tcgetattr() возвращает параметры, связанные с объектом, на который ссылается fd, сохраняя их в структуре termios, на которую указывает termios_p. Эта функция может быть вызвана из фонового процесса; однако, атрибуты терминала могут в дальнейшем измениться активным процессом.
Функция tcsetattr() изменяет параметры терминала (если это позволяет используемое оборудование) из структуры termios, на которую указывает termios_p. В optional_actions задаётся, когда параметры должны начать действовать:
- TCSANOW
- Изменения начинают действовать немедленно.
- TCSADRAIN
- Изменения начинают действовать после того, как переданы все данные для вывода, записанные в fd. Это действие должно использоваться при работе с параметрами, которые влияют на вывод.
- TCSAFLUSH
- Изменения начинают действовать после того, как все данные, записанные в объект, на который указывает fd, были переданы, и все данные, которые были приняты, но не прочитаны, были отброшены.
Канонический и неканонический режим¶
Флагом ICANON в c_lflag определяется, в каком режиме работает терминал: в каноническом режиме (ICANON установлен), и неканоническом (ICANON не установлен). По умолчанию ICANON установлен.
В каноническом режиме:
- •
- Вводимые данные становятся доступны построчно. Входная строка становится доступна после набора одного из разделителей строк (NL, EOL, EOL2 или EOF в начале строки). За исключением EOF, разделитель строк добавляется в буфер, возвращаемый read(2).
- •
- Включено редактирование строки (ERASE, KILL; и, если указан флаг IEXTEN — WERASE, REPRINT, LNEXT). Вызов read(2) возвращает не более одной строки ввода; если read(2) запрашивает меньше байт, чем доступно в текущей вводимой строке, то читается только количество запрошенных байт, а оставшиеся символы будут доступны для следующего read(2).
- •
- Максимальная длина строки - 4096 символов (включая завершающий символ перевода строки); строки длиннее 4096 символов будут обрезаны. После 4095 символов обработка ввода (то есть обработка ISIG и ECHO*) продолжится, однако любые входящие данные после 4095 символов до (но не включая) любого завершающего символа новой строки будут отбрасываться. Благодаря этому терминал всегда сможет принять больше входящих данных до тех пор, пока не появится хотя бы один перевод строки.
В неканоническом режиме вводимые данные доступны сразу (без введённого пользователем символа разделителя строк), обработка ввода не выполняется и редактирование строки выключено. Буфер чтения принимает только 4095 символов; благодаря этому, в случае, если режим ввода переключится в канонический, резервируется необходимое место для символа новой строки. Настройками MIN (c_cc[VMIN]) и TIME (c_cc[VTIME]) задаются условия, при которых выполняется read(2); есть четыре варианта:
- MIN == 0, TIME == 0 (чтение опросом (polling read))
- Если данные доступны, то read(2) завершает выполнение сразу, возвращая меньшее или запрошенное количество байт. Если данных нет, то read(2) возвращает 0.
- MIN > 0, TIME == 0 (блокирующее чтение)
- Вызов read(2) блокирует выполнение, пока не будет доступно MIN байт, и возвращает не более количества запрашиваемых байт.
- MIN == 0, TIME > 0 (чтение с блокировкой по времени (read with timeout))
- В TIME указывается время срабатывания таймера в десятых долях секунды. Таймер запускается при вызове read(2). Вызов read(2) завершается, когда не менее одного байта станет доступно, или когда сработает таймер. Если таймер сработал, а данных не появилось, то read(2) возвращает 0. Если на момент вызова read(2) данные уже были, то вызов действует так, как если бы данные были получены сразу после вызова.
- MIN > 0, TIME > 0 (чтение с блокировкой по времени между байтами (read with interbyte timeout))
- В TIME указывается время срабатывания таймера в десятых долях секунды. После того, как первый байт станет доступен, таймер перезапускается после каждого полученного байта. Вызов read(2) возвращает результат после удовлетворения любого из следующих условий:
- Так как таймер запускается только после приёма начального байта, будет прочитан, как минимум, один байт. Если на момент вызова read(2) данные уже были, то вызов действует так, как если бы данные были получены сразу после вызова.
В POSIX не указано, имеет ли флаг состояния файла O_NONBLOCK приоритет над настройками MIN и TIME. Если O_NONBLOCK установлен, то read(2) в неканоническом режиме может вернуть управление сразу же, независимо от настройки MIN или TIME. Более того, если данных нет, то в POSIX разрешено read(2) в неканоническом режиме вернуть или 0, или -1 с установкой errno равной EAGAIN.
Режим без обработки¶
Функция cfmakeraw() переводит терминал в нечто похожее на режим «raw» старого драйвера терминала Version 7: ввод доступен символ за символом, эхо отключено и все специальные обработки символов при вводе и выводе также отключены. Задаются следующие атрибуты терминала:
termios_p->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP
| INLCR | IGNCR | ICRNL | IXON); termios_p->c_oflag &= ~OPOST; termios_p->c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN); termios_p->c_cflag &= ~(CSIZE | PARENB); termios_p->c_cflag |= CS8;
Управление линией¶
tcsendbreak() transmits a continuous stream of zero-valued bits for a specific duration, if the terminal is using asynchronous serial data transmission. If duration is zero, it transmits zero-valued bits for at least 0.25 seconds, and not more than 0.5 seconds. If duration is not zero, it sends zero-valued bits for some implementation-defined length of time.
Если терминал не использует асинхронную передачу данных, то tcsendbreak() заканчивает работу, не предпринимая каких-либо действий.
Функция tcdrain() ждёт, пока все данные вывода, записанные в объект, на который ссылается fd, не будут переданы.
Функция tcflush() отбрасывает (discards) данные, записанные, но не переданные в объект, на который ссылается fd, или принятые, но не прочитанные (в зависимости от значения queue_selector):
- TCIFLUSH
- Отбросить принятые, но не прочитанные данные.
- TCOFLUSH
- Отбросить записанные, но не переданные данные.
- TCIOFLUSH
- Отбросить принятые, но не прочитанные данные и записанные, но не переданные данные.
Функция tcflow() задерживает передачу или приём данных объектом, на который ссылается fd (в зависимости от значения action):
- TCOOFF
- Задержать вывод.
- TCOON
- Возобновить задержанный вывод.
- TCIOFF
- Передать символ STOP, который останавливает передачу данных в систему с устройства терминала.
- TCION
- Передать символ START, который начинает передачу данных в систему с устройства терминала.
По умолчанию при открытии файла терминала ни ввод, ни вывод не приостановлены.
Скорость линии¶
Функции работы со скоростью передачи (в бодах) предназначены для получения и установки значений скоростей ввода и вывода в структуре termios. Новые значения не действуют, пока не будет вызвана tcsetattr().
При установке скорости B0 модему передаётся команда «повесить трубку». Фактическая скорость, соответствующая B38400, может быть изменена с помощью setserial(8).
Скорости ввода и вывода хранятся в структуре termios.
Функция cfgetospeed() возвращает скорость вывода данных, хранящуюся в структуре termios, на которую указывает termios_p.
Функция cfsetospeed() устанавливает скорость вывода данных из поля speed структуры termios, на которую указывает termios_p. Значение должно быть равно одной из следующих констант:
These constants are additionally supported on the SPARC architecture:
These constants are additionally supported on non-SPARC architectures:
Due to differences between architectures, portable applications should check if a particular Bnnn constant is defined prior to using it.
The zero baud rate, B0, is used to terminate the connection. If B0 is specified, the modem control lines shall no longer be asserted. Normally, this will disconnect the line. CBAUDEX is a mask for the speeds beyond those defined in POSIX.1 (57600 and above). Thus, B57600 & CBAUDEX is nonzero.
Setting the baud rate to a value other than those defined by Bnnn constants is possible via the TCSETS2 ioctl; see ioctl_tty(2).
Функция cfgetispeed() возвращает скорость ввода данных, хранящуюся в структуре termios.
cfsetispeed() sets the input baud rate stored in the termios structure to speed, which must be specified as one of the Bnnn constants listed above for cfsetospeed(). If the input baud rate is set to the literal constant 0 (not the symbolic constant B0), the input baud rate will be equal to the output baud rate.
Функция cfsetspeed() является расширением 4.4BSD. Она имеет те же аргументы что и cfsetispeed(), и задаёт сразу скорость и ввода и вывода.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
Функция cfgetispeed() возвращает скорость ввода данных, хранящуюся в структуре termios.
Функция cfgetospeed() возвращает скорость вывода данных, хранящуюся в структуре termios.
Все остальные функции возвращают:
- 0
- при успешном выполнении.
- -1
- при ошибках и errno присваивается код ошибки.
Заметим, что tcsetattr() завершается без ошибок, если любое запрошенное изменение было успешно выполнено. Поэтому, при одновременном изменении нескольких параметров, может понадобиться вызвать tcgetattr() для того, чтобы убедиться, что все изменения были выполнены.
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
tcgetattr(), tcsetattr(), tcdrain(), tcflush(), tcflow(), tcsendbreak(), cfmakeraw(), cfgetispeed(), cfgetospeed(), cfsetispeed(), cfsetospeed(), cfsetspeed() | Безвредность в нитях | MT-Safe |
СТАНДАРТЫ¶
Функции tcgetattr(), tcsetattr(), tcsendbreak(), tcdrain(), tcflush(), tcflow(), cfgetispeed(), cfgetospeed(), cfsetispeed() и cfsetospeed() определены в POSIX.1-2001.
Функций cfmakeraw() и cfsetspeed() нет в стандарте, но есть в BSD.
ЗАМЕЧАНИЯ¶
UNIX V7 and several later systems have a list of baud rates where after the values B0 through B9600 one finds the two constants EXTA, EXTB ("External A" and "External B"). Many systems extend the list with much higher baud rates.
Ненулевое значение duration с tcsendbreak() приводит к неизвестному результату. В SunOS задана пауза duration * N секунд, где N равно не менее 0.25, и не более 0.5. В Linux, AIX, DU, Tru64 делается пауза в duration миллисекунд. В FreeBSD и NetBSD и HP-UX и MacOS значение duration игнорируется. В Solaris и UnixWare функция tcsendbreak() с ненулевым duration работает аналогично tcdrain().
ДЕФЕКТЫ¶
On the Alpha architecture before Linux 4.16 (and glibc before glibc 2.28), the XTABS value was different from TAB3 and it was ignored by the N_TTY line discipline code of the terminal driver as a result (because as it wasn't part of the TABDLY mask).
СМ. ТАКЖЕ¶
reset(1), setterm(1), stty(1), tput(1), tset(1), tty(1), ioctl_console(2), ioctl_tty(2), cc_t(3type), speed_t(3type), tcflag_t(3type), setserial(8)
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
5 февраля 2023 г. | Linux man-pages 6.03 |