tcgetattr函数

约定不等于承诺〃 2024-02-18 20:28 24阅读 0赞

tcgetattr函数用于获取与终端相关的参数。参数fd为终端的[文件描述符][Link 1]，返回的结果保存在termios[结构体][Link 2]中，该结构体一般包括如下的成员：

tcflag\_t c\_iflag;

tcflag\_t c\_oflag;

tcflag\_t c\_cflag;

tcflag\_t c\_lflag;

cc\_t c\_cc\[NCCS\];

其具体意义如下。

c\_iflag：输入模式标志，控制终端输入方式，具体参数如表1所示。

表1 c\_iflag参数表

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:middle;"> 键 值 </td> 
 <td style="vertical-align:middle;"> 说 明 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IGNBRK </td> 
 <td style="vertical-align:middle;"> 忽略BREAK键输入 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> BRKINT </td> 
 <td style="vertical-align:middle;"> 如果设置了IGNBRK，BREAK键输入将被忽略 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IGNPAR </td> 
 <td style="vertical-align:middle;"> 忽略奇偶校验错误 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> PARMRK </td> 
 <td style="vertical-align:middle;"> 标识奇偶校验错误 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> INPCK </td> 
 <td style="vertical-align:middle;"> 允许输入奇偶校验 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> ISTRIP </td> 
 <td style="vertical-align:middle;"> 去除字符的第8个比特 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> INLCR </td> 
 <td style="vertical-align:middle;"> 将输入的NL（换行）转换成CR（回车） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IGNCR </td> 
 <td style="vertical-align:middle;"> 忽略输入的回车 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> ICRNL </td> 
 <td style="vertical-align:middle;"> 将输入的回车转化成换行（如果IGNCR未设置的情况下） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IUCLC </td> 
 <td style="vertical-align:middle;"> 将输入的大写字符转换成小写字符（非POSIX） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IXON </td> 
 <td style="vertical-align:middle;"> 允许输入时对XON/XOFF流进行控制 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IXANY </td> 
 <td style="vertical-align:middle;"> 输入任何字符将重启停止的输出 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IXOFF </td> 
 <td style="vertical-align:middle;"> 允许输入时对XON/XOFF流进行控制 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> IMAXBEL </td> 
 <td style="vertical-align:middle;"> 当输入队列满的时候开始响铃 </td> 
 </tr> 
 </tbody> 
</table>

c\_oflag：输出模式标志，控制终端输出方式，具体参数如表2所示。

表2 c\_oflag参数

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;"> 键 值 </td> 
 <td style="vertical-align:top;"> 说 明 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> OPOST </td> 
 <td style="vertical-align:top;"> 处理后输出 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> OLCUC </td> 
 <td style="vertical-align:top;"> 将输入的小写字符转换成大写字符（非POSIX） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> ONLCR </td> 
 <td style="vertical-align:top;"> 将输入的NL（换行）转换成CR（回车）及NL（换行） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> OCRNL </td> 
 <td style="vertical-align:top;"> 将输入的CR（回车）转换成NL（换行） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> ONOCR </td> 
 <td style="vertical-align:top;"> 第一行不输出回车符 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> ONLRET </td> 
 <td style="vertical-align:top;"> 不输出回车符 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> OFILL </td> 
 <td style="vertical-align:top;"> 发送填充字符以延迟终端输出 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> OFDEL </td> 
 <td style="vertical-align:top;"> 以ASCII码的DEL作为填充字符，如果未设置该参数，填充字符为NUL </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> NLDLY </td> 
 <td style="vertical-align:top;"> 换行输出延时，可以取NL0（不延迟）或NL1（延迟0.1s） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> CRDLY </td> 
 <td style="vertical-align:top;"> 回车延迟，取值范围为：CR0、CR1、CR2和 CR3 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> TABDLY </td> 
 <td style="vertical-align:top;"> 水平制表符输出延迟，取值范围为：TAB0、TAB1、TAB2和TAB3 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> BSDLY </td> 
 <td style="vertical-align:top;"> 空格输出延迟，可以取BS0或BS1 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VTDLY </td> 
 <td style="vertical-align:top;"> 垂直制表符输出延迟，可以取VT0或VT1 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> FFDLY </td> 
 <td style="vertical-align:top;"> 换页延迟，可以取FF0或FF1 </td> 
 </tr> 
 </tbody> 
</table>

c\_cflag：控制模式标志，指定终端硬件控制信息，具体参数如表3所示。

表3 c\_cflag参数

c\_lflag：本地模式标志，控制终端编辑功能，具体参数如表4所示。

表4 c\_lflag参数

c\_cc\[NCCS\]：控制字符，用于保存终端驱动程序中的特殊字符，如输入结束符等。c\_cc中定义了如表5所示的控制字符。

表5 c\_cc支持的控制字符

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;"> 宏 </td> 
 <td style="vertical-align:top;"> 说 明 </td> 
 <td style="vertical-align:top;"> 宏 </td> 
 <td style="vertical-align:top;"> 说 明 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VINTR </td> 
 <td style="vertical-align:top;"> Interrupt字符 </td> 
 <td style="vertical-align:top;"> VEOL </td> 
 <td style="vertical-align:top;"> 附加的End-of-file字符 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VQUIT </td> 
 <td style="vertical-align:top;"> Quit字符 </td> 
 <td style="vertical-align:top;"> VTIME </td> 
 <td style="vertical-align:top;"> 非规范模式读取时的超时时间 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VERASE </td> 
 <td style="vertical-align:top;"> Erase字符 </td> 
 <td style="vertical-align:top;"> VSTOP </td> 
 <td style="vertical-align:top;"> Stop字符 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VKILL </td> 
 <td style="vertical-align:top;"> Kill字符 </td> 
 <td style="vertical-align:top;"> VSTART </td> 
 <td style="vertical-align:top;"> Start字符 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VEOF </td> 
 <td style="vertical-align:top;"> End-of-file字符 </td> 
 <td style="vertical-align:top;"> VSUSP </td> 
 <td style="vertical-align:top;"> Suspend字符 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> VMIN </td> 
 <td style="vertical-align:top;"> 非规范模式读取时的最小字符数 </td> 
 <td style="vertical-align:top;"> </td> 
 <td style="vertical-align:top;"> </td> 
 </tr> 
 </tbody> 
</table>

tcsetattr函数用于设置终端的相关参数。参数fd为打开的终端文件描述符，参数optional\_actions用于控制修改起作用的时间，而结构体termios\_p中保存了要修改的参数。

optional\_actions可以取如下的值：

TCSANOW：不等数据传输完毕就立即改变属性。

TCSADRAIN：等待所有数据传输结束才改变属性。

TCSAFLUSH：清空输入输出缓冲区才改变属性。

错误信息：

EBADF：非法的文件描述符。

EINTR：tcsetattr函数调用被信号中断。

EINVAL：参数optional\_actions使用了非法值，或参数termios中使用了非法值。

ENCTTY：非终端的文件描述符。

### 范例 ###

\#include <stdio.h>