`

终端规范模式和非规范模式

阅读更多
    终端规范模式很简单:发一个读请求,当一行已经输入后,终端驱动程序立即返回。以下几个条件都会造成读返回。
    1、所请求的字节数已读到时。此时无需读一个完整的行,如果读了部分行,也不会丢失任何信息,下一次读会从前一次读的停止处开始。
    2、当读到一个行定界符时。在终端特殊输入字符一节中已了解到,下列字符在规范模式中会被解释为“行结束”:NL、EOL、EOL2 和 EOF,还有如若已设置 ICRNL,但未设置 IGNCR,则 CR 字符的作用与 NL 字符一样,也会终止一行。
    3、如果捕捉到信号,并且该函数不再自动重启,则读也会返回。
    下面来看看 getpass 函数在 UNIX 系统中的一个典型实现。此函数由 login(1) 和 crypt(1) 程序调用。它读入用户在终端上键入的口令,它关闭了回显,但仍以规范模式工作,因为不管键入什么口令都能构成一个完整行。
#include <stdio.h>
#include <signal.h>
#include <termios.h>

#define MAX_PASS_LEN	8		// max #chars for user to enter

char *getpass(const char *prompt){
	static char buf[MAX_PASS_LEN+1];	// null	byte at end

	sigset_t	set, oset;
	sigemptyset(&set);
	sigaddset(&set, SIGINT);		// block SIGSET
	sigaddset(&set, SIGTSTP);		// block SIGTSTP
	sigprocmask(SIG_BLOCK, &set, &oset);	// and save mask

	FILE *fp;
	if((fp=fopen(ctermid(NULL), "r+")) == NULL)
		return NULL;
	setbuf(fp, NULL);				// close I/O buffer
	struct termios	termst, otermst;
	tcgetattr(fileno(fp), &termst);			// save tty state
	otermst = termst;				// structure copy
	termst.c_lflag &= ~(ECHO |ECHOE |ECHOK | ECHONL);	// disable echo
	tcsetattr(fileno(fp), TCSAFLUSH, &termst);

	fputs(prompt, fp);
	char *str = buf;
	int ch;
	while((ch=getc(fp))!=EOF && ch != '\n'){
		if(str < &buf[MAX_PASS_LEN])
			*str++ = ch;
	}
	*str = 0;			// null terminate
	putc('\n', fp);		// echo a newline

	tcsetattr(fileno(fp), TCSAFLUSH, &otermst);	// restore tty state
	sigprocmask(SIG_SETMASK, &oset, NULL);		// restore signal mask
	fclose(fp);
	return buf;
}

int main(void){
	char *ptr;
	if((ptr=getpass("Enter password: ")) == NULL){
		printf("getpass error\n");
		return 1;
	}
	printf("password: %s\n", ptr);
	while(*ptr != 0)
		*ptr++ = 0;		// zero it out when we're done with it
	return 0;
}

    关于本程序,需要注意以下几个方面。
    1、阻塞了信号 SIGINT 和 SIGTSTP。否则在输入 INTR 字符 或 SUSP 字符时都会使程序终止,然后在禁止回显状态下返回到终端。但没有一个 getpass 版本捕捉、忽略或阻塞 SIGQUIT 信号,所以输入 QUIT 字符就会使程序异常终止,并且很可能使终端保持在禁止回显状态。
    2、关闭了标准 I/O 流的缓冲,以免在读、写之间产生某些交叉(这样就需要多次调用 fflush)。也可使用不带缓冲的 I/O,但这样就需要使用 read 来模仿 getc 函数。
    3、由于 getpass 中使用静态存储区来存储输入的明文口令,所以为了安全起见,在程序完成后应在内存中消除它。因为要是该程序会产生其他用户可能读取的 core 文件(core 的系统默认许可权使每个用户都能读它),或者如果某个其他进程能够设法读该进程的存储空间,则它们就可能会读到这个口令。当然也可以在 getpass 中将该口令加密存储。

    可以通过关闭 termios 结构中 c_lflag 字段的 ICANON 标志来指定非规范模式。在非规范模式中,输入数据不装配成行,不处理下列特殊字符:ERASE、KILL、EOF、NL、EOL、EOL2、CR、REPRINT、STATUS 和 WERASE(见终端特殊输入字符)。当读取了指定量的数据,或者已经超过了给定量的时间后,就会通知系统返回数据。这使用了 termios 结构中 c_cc 数组的两个下标为 VMIN 和 VTIME 的两个变量:MIN 和 TIME。MIN 指定一个 read 返回前的最小字节数,TIME 指定等待数据到达的分秒数(分秒为秒的 1/10)。有下列 4 种情形。
    1、MIN > 0,TIME > 0:TIME 指定一个字节间定时器(interbyte timer),它只在第一个字节被接收时启动(这意味着在定时器超时时,read 至少会返回一个字节)。在定时器超时之前,若已接收到 MIN 个字节,则 read 返回 MIN 个字节。如果在接到 MIN 个字节之前,该定时器已超时,则 read 返回已接收到的字节。
    2、MIN > 0,TIME = 0:read 在接收到 MIN 个字节之前不返回。这可能会使 read 长期阻塞。
    3、MIN = 0,TIME > 0:这里的 TIME 指定的是一个在调用 read 时就会立即启动的读定时器。在接到一个字节或者该定时器超时时,read 即返回。如果是定时器超时,则 read 返回 0。
    4、MIN = 0,TIME = 0:如果有数据可用,则 read 最多返回所要求的字节数。否则立即返回 0。
    注意,为了兼容性,POSIX.1 允许下标 VMIN 和 VTIME 的值可分别与 VEOF 和 VEOL 的相同,但这同时也带来了可移植性问题。从非规范模式转换为规范模式时,必须恢复 VEOF 和 VEOL。例如,如果 VMIN 等于 VEOF,且不恢复它们的值,那么当把 VMIN 的典型值设置为 1 时,文件结束符就变成了 Ctrl+A。解决这一问题最简单的方法是:在要转入非规范模式时,将整个 termios 结构保存起来,以后再要转会规范模式时恢复它。
    下面这个程序中的函数 tty_cbreak 和 tty_raw 分别将终端设置为 cbreak 模式(cbreak mode)和原始模式(raw mode)。在这两种模式之间转换时,需要先调用 tty_reset 函数,它将终端恢复到调用 tty_cbreak 或 tty_raw 之前的工作状态,以减少出错时终端处于不可用状态的机会。程序中还提供了另外两个函数 tty_atexit 和 tty_termios。tty_atexit 可被登记为退出处理程序,以保证 exit 时恢复终端工作模式。tty_termios 则返回一个指向原来规范模式下 termios 结构的指针。不过在查看代码之前,先看一下 cbreak 模式和 raw 模式要满足的要求,其中涉及到的终端标志介绍可见终端 I/O 综述
    cbreak 模式要满足的要求如下。
    1、非规范模式。如上文所述,这种模式关闭了对某些输入字符的处理,但没有关闭对信号的处理。调用者一般应当捕捉这些信号,以免使程序终止,导致终端保持在 cbreak 模式。
    2、关闭回显。
    3、每次输入一个字节。为此,可将 MIN 和 TIME 分别设置为 1 和 0。
    raw 模式要满足的要求如下。
    1、非规范模式,同时还关闭了对信号产生字符 ISIG 和扩充输入字符 IEXTEN 的处理,另外还禁用了 BRKINT 字符,使 BREAK 字符不再产生信号。
    2、关闭回显。
    3、禁止输入中的 CR 到 NL 映射 ICRNL、输入奇偶检测 INPCK、剥离输入字节的第 8 位 ISTRIP 以及输出流控制 IXON。
    4、8 位字符 CS8,且禁用奇偶校验 PARENB。
    5、禁止所有输出处理 OPOST。
    6、每次输入一个字节(MIN=1, TIME=0)。
#include <stdio.h>
#include <stdlib.h>
#include <termios.h>
#include <errno.h>
#include <unistd.h>
#include <signal.h>

static struct termios	save_termios;
static int				ttysavefd = -1;
static enum{RESET, RAW, CBREAK}	ttystate = RESET;

int tty_cbreak(int fd){		// put terminal into a cbreak mode
	if(ttystate != RESET){
		errno = EINVAL;
		return -1;
	}
	struct termios	buf;
	if(tcgetattr(fd, &buf) < 0)
		return -1;
	save_termios = buf;		// structure copy
	buf.c_lflag &= ~(ECHO | ICANON);	// echo off, canonical mode off
	buf.c_cc[VMIN] = 1;		// 1 byte at a time,
	buf.c_cc[VTIME] = 0;	// and no timer
	if(tcsetattr(fd, TCSAFLUSH, &buf) < 0)
		return -1;
	//Varify that the changes stuck. tcsetattr can return 0 on partial success
	int err;
	if(tcgetattr(fd, &buf) < 0){
		err = errno;
		tcsetattr(fd, TCSAFLUSH, &save_termios);
		errno = err;
		return -1;
	}
	if((buf.c_lflag & (ECHO |ICANON)) || buf.c_cc[VMIN]!=1 || buf.c_cc[VTIME
]!=0){
		//only some of the changes were made, restore the original settings
		tcsetattr(fd, TCSAFLUSH, &save_termios);
		errno = EINVAL;
		return -1;
	}
	ttystate = CBREAK;
	ttysavefd = fd;
	return 0;
}

int tty_raw(int fd){	// put terminal into a raw mode
	if(ttystate != RESET){
		errno = EINVAL;
		return -1;
	}
	struct termios	buf;
	if(tcgetattr(fd, &buf) < 0)
		return -1;
	save_termios = buf;		// structure copy
	buf.c_lflag &= ~(ECHO |ICANON |IEXTEN |ISIG);
	buf.c_iflag &= ~(BRKINT |ICRNL |INPCK |ISTRIP | IXON);
	buf.c_cflag &= ~(CSIZE |PARENB);
	buf.c_cflag |= CS8;		// set 8 bits/char
	buf.c_oflag &= ~(OPOST);
	buf.c_cc[VMIN] = 1;
	buf.c_cc[VTIME] = 0;
	if(tcsetattr(fd, TCSAFLUSH, &buf) < 0)
		return -1;
	int err;
	if(tcgetattr(fd, &buf) < 0){
		err = errno;
		tcsetattr(fd, TCSAFLUSH, &save_termios);
		errno = err;
		return -1;
	}
	if((buf.c_lflag & (ECHO |ICANON |IEXTEN |ISIG)) ||
		(buf.c_iflag & (BRKINT |ICRNL |INPCK |ISTRIP |IXON)) ||
		(buf.c_cflag & (CSIZE |PARENB |CS8)) != CS8 ||
		(buf.c_oflag & OPOST) || buf.c_cc[VMIN]!=1 || buf.c_cc[VTIME]!=0
)
	{
		tcsetattr(fd, TCSAFLUSH, &save_termios);	
		errno = EINVAL;
		return -1;
	}
	ttystate = RAW;
	ttysavefd = fd;
	return 0;
}

int tty_reset(int fd){		// restore terminal's mode
	if(ttystate == RESET)
		return 0;
	if(tcsetattr(fd, TCSAFLUSH, &save_termios) < 0)
		return -1;
	ttystate = RESET;
	return 0;
}

void tty_atexit(void){		// can be set up by atexit(tty_atexit);
	if(ttysavefd >= 0)
		tty_reset(ttysavefd);
}

struct termios *tty_termios(void){	// let caller see original tty state
	return &save_termios;
}

/* ======================= test ============================ */
static void sig_catch(int signo){
	printf("signal caught\n");
	tty_reset(STDIN_FILENO);
	exit(0);
}

int main(void){
	atexit(tty_atexit);
	signal(SIGINT, sig_catch);		// catch SIGINT
	signal(SIGQUIT, sig_catch);		// catch SIGQUIT
	signal(SIGTERM, sig_catch);		// catch SIGTERM

	int	i;
	char c;
	if(tty_raw(STDIN_FILENO) < 0){
		printf("tty_raw error\n");
		return 1;
	}
	printf("Enter raw mode characters, terminate with Backspace\n");
	while((i=read(STDIN_FILENO, &c, 1)) == 1){
		if((c &= 255) == 0177)		// 0177 = ASCII Backspace
			break;
		printf("%#o\n", c);
	}
	if(i <= 0){
		printf("read error\n");
		return 1;
	}

	tty_reset(STDIN_FILENO);

	if(tty_cbreak(STDIN_FILENO) < 0){
		printf("tty_cbreak error\n");
		return 1;
	}
	printf("\nEnter cbreak mode characters, terminate with SIGINT\n");
	while((i=read(STDIN_FILENO, &c, 1)) == 1)
		printf("%#o\n", c & 255);
	if(i <= 0){
		printf("read error\n");
		return 1;
	}

	tty_reset(STDIN_FILENO);
	return 0;
}

    编译后运行该程序,可以观察到两种终端模式的工作情况如下。
$ ./termmode.out 
Enter raw mode characters, terminate with Backspace
                                                   04            # Ctrl+D
                                                     03          # Ctrl+C
                                                       033       # F7
                                                          0133
                                                              061
                                                                 070
                                                                    0176
                                                        # Backspace
Enter cbreak mode characters, terminate with SIGINT
01                     # Ctrl+A
0177                   # Backspace
signal caught          # Ctrl+C

    这里,在原始模式中,输入的字符是文件结束符 Ctrl+D(04)、中断符 Ctrl+C(03)和特殊功能键 F7。该功能键在本人所用的终端上产生 5 个字符:ESC(033)、[(0133)、字符 1(061)、字符 8(070)和 ~(0176)。注意,因为在原始模式下关闭了输出处理(~OPOST),所以在每个字符后没有得到回车符。在 cbreak 模式下,不对特殊输入字符进行处理,但是仍对终端产生的信号进行处理。
分享到:
评论

相关推荐

    中国移动TD-LTE终端总体技术规范

    TD-LTE终端模式是指终端设备的基本模式,包括FDD模式和TDD模式。FDD模式是 Frequency Division Duplex模式,即频分duplex模式,在这种模式下,上传和下载使用不同的频率。TDD模式是 Time Division Duplex模式,即...

    中国移动终端测试规范

    综上所述,《中国移动终端测试规范》是一份综合性的技术文件,它不仅规定了测试流程和方法,而且还对测试环境和设备配置提出了明确要求,为确保电动自行车防盗监控产品的可靠性和稳定性提供了技术保障。这些测试要求...

    中国移动VoLTE终端技术规范V2_volte_

    7. 兼容性和互操作性:VoLTE终端需要与其他VoLTE终端以及非VoLTE终端(通过CSFB)进行互操作,确保跨网络、跨厂商的通话兼容性。 综上所述,中国移动VoLTE终端技术规范V2是指导VoLTE终端制造商和开发者遵循的技术...

    中国电信1x增强型终端需求系列规范系列

    在《中国电信1x增强型终端需求规范-Rev A技术要求分册-V1.1》中,你会找到关于1xEV-DO Rev A终端的基本功能、性能指标、接口要求、操作模式、功率控制、多播服务、安全性和网络兼容性等方面的规定。这些要求确保了...

    中国移动A-GPS终端技术规范V4.0.0

    - 规定了终端支持的定位模式,如自主定位模式和辅助定位模式等。 ##### 2. 鉴权与安全 - 描述了终端在进行定位请求时的安全机制,如鉴权流程、加密方式等。 ##### 3. 支持DM功能 - DM(Device Management)功能...

    TCESA 1160-2021 移动智能终端未成年人保护通用规范.pdf

    根据TCESA 1160-2021标准,移动智能终端的未成年人保护模式设置应包括未成年人保护模式入口、未成年人保护模式退出和未成年人保护模式显见性三个方面。其中,未成年人保护模式入口是指用户可以通过特定的操作进入未...

    中国移动 M2M平台与终端接口规范_WMMP_V2.0

    **中国移动 M2M平台与终端接口规范_WMMP_V2.0** 是一个全面而详尽的标准文档,它不仅定义了M2M业务中终端与平台之间的通信接口,还详细描述了WMMP协议的工作原理和各种功能流程,为M2M系统的开发、集成和运维提供了...

    2011直联POS终端规范&IC卡规范(全13本)

    《2011直联POS终端规范&IC卡规范(全13本)》是一部集成了2011年中国金融行业内对于直联POS终端和集成电路(IC)卡使用的重要指导文件。这一规范的发布旨在确保金融交易的安全性、稳定性和标准化,推动银行卡产业的...

    银联pos机终端规范

    《银联POS机终端规范》是中国银联针对银行磁条卡销售点终端制定的一套详细技术与操作标准,旨在确保各类磁条卡交易的安全、高效和标准化。此规范适用于国内及可能涉及的国际磁条卡交易,所有交易通过通信网络直接...

    中国移动 4G TD-LTE终端技术规范

    《中国移动4G TD-LTE终端技术规范》是中国移动在4G通信时代对于TD-LTE(Time Division Long Term Evolution,时分长期演进)终端设备制定的一套详细的技术标准和要求,旨在确保终端设备与网络之间的兼容性和高效通信...

    AGPS规范 终端A-GPS技术规范

    终端应支持多种定位模式,包括但不限于自主定位模式和辅助定位模式。这两种模式各有侧重:自主定位模式利用终端自身的GPS接收器进行定位;辅助定位模式则是在网络的帮助下提高定位速度和准确性。 **2.2 鉴权与安全*...

    华为NB-IoT终端接入规范

    4. **消息传输协议**:通常,NB-IoT终端采用NAS(非接入层)和RLC(无线链路控制)协议来传输控制和用户数据。规范会规定如何使用这些协议来保证数据的可靠传输。 5. **服务质量(QoS)**:针对不同业务需求,规范...

    pos 终端规范文档

    1. **交易确认机制**:为了解决蜂鸣器和指示灯在实际应用中无法清晰区分卡片受理成功或失败的问题,规范建议改进终端的反馈机制,比如通过调整蜂鸣器声音的间隔或模式,使用户能更准确地判断交易状态。 2. **交易...

    北斗卫星导航系统位置报告和短报文型终端通用规范.pdf

    终端根据所利用的业务和服务模式分为北斗RDSS终端和北斗RNSS终端。 北斗RDSS终端是利用RDSS业务的终端,能够提供定位、导航、定时、位置报告和短报文通信功能。其中,指挥管理型终端是一种特殊的北斗RDSS终端,具备...

    基于中国电信运营商视角的物联网终端发展模式及发展策略研究

    本文深入分析了基于国际运营商物联网发展实践经验的三种主流物联网终端发展模式,并结合中国电信运营商的特点,提出了适合我国电信运营商的物联网终端发展模式和核心发展策略。 研究物联网终端发展模式和策略时,...

    中国移动终端A-GPS技术规范

    1. **功能要求**:明确了A-GPS终端必须具备的功能,如定位技术要求、后备定位技术要求、节电模式、显示和键盘要求等。其中,定位技术要求特别强调了终端应能支持多种定位方式,并能在不同环境下实现快速、准确的定位...

    智能手机型移动警务终端:安全监控组件技术规范

    《智能手机型移动警务终端:安全监控组件技术规范》是GA∕T 1466.2-2018标准的一部分,它详细规定了在移动警务应用中,智能手机作为核心设备的安全监控组件应具备的技术要求和操作规范。该文档旨在确保警务人员在...

Global site tag (gtag.js) - Google Analytics