18.7. tty_operaions 结构的细节

18.7. tty_operaions 结构的细节

tty_operations 结构包含所有的函数回调, 可以被一个 tty 驱动设置和被 tty 核心调用. 当前, 所有包含在这个结构中的的函数指针也在 tty_driver 结构中, 但是会很快被只有一个这个结构的实例来替代.

int (open)(struct tty_struct tty, struct file * filp);
open 函数.

void (close)(struct tty_struct tty, struct file * filp);
close 函数.

int (write)(struct tty_struct tty, const unsigned char *buf, int count);
write 函数.

void (put_char)(struct tty_struct tty, unsigned char ch);
单字节写函数. 这个函数被 tty 核心调用当单个字节被写入设备. 如果一个 tty 驱动没有定义这个函数, write 函数被调用来替代, 当 tty 核心想发送一个单个字节.

void (flush_chars)(struct tty_struct tty);void (wait_until_sent)(struct tty_struct tty, int timeout);
刷新数据到硬件的函数.

int (write_room)(struct tty_struct tty);
指示多少缓冲空闲的函数.

int (chars_in_buffer)(struct tty_struct tty);
指示多少缓冲满数据的函数.

int (ioctl)(struct tty_struct tty, struct file * file, unsigned int cmd, unsigned long arg);
ioctl 函数. 这个函数被 tty 核心调用, 当 ioctl(2)在设备节点上被调用时.

void (set_termios)(struct tty_struct tty, struct termios * old);
set_termios 函数. 这个函数被 tty 核心调用, 当设备的 termios 设置已被改变时.

void (throttle)(struct tty_struct tty);void (unthrottle)(struct tty_struct tty);void (stop)(struct tty_struct tty);void (start)(struct tty_struct tty);
数据抑制函数. 这些函数用来帮助控制 tty 核心的输入缓存. 这个抑制函数被调用当 tty 核心的输入缓冲满. tty 驱动应当试图通知设备不应当发送字符给它. unthrottle 函数被调用当 tty 核心的输入缓冲已被清空, 并且它现在可以接收更多数据. tty 驱动应当接着通知设备可以接收数据. stop 和 start 函数非常象 throttle 和 unthrottle 函数, 但是它们表示 tty 驱动应当停止发送数据给设备以及以后恢复发送数据.

void (hangup)(struct tty_struct tty);
挂起函数. 这个函数被调用当 tty 驱动应当挂起 tty 设备. 任何需要做的特殊的硬件操作应当在此时发生.

void (break_ctl)(struct tty_struct tty, int state);
线路中断控制函数. 这个函数被调用当这个 tty 驱动要打开或关闭线路的 BREAK 状态在 RS-232 端口上. 如果状态设为 -1, BREAK 状态应当打开. 如果状态设为 0, BREAK 状态应当关闭. 如果这个函数由 tty 驱动实现, tty 核心将处理 TCSBRK, TCSBRKP, TIOCSBRK, 和 TIOCCBRK ioctl. 否则, 这些 ioctls 被发送给驱动 ioctl 函数.

void (flush_buffer)(struct tty_struct tty);
刷新缓冲和丢失任何剩下的数据.

void (set_ldisc)(struct tty_struct tty);
设置线路规程的函数. 这个函数被调用当 tty 核心已改变这个 tty 驱动的线路规程. 这个函数通常不用并且不应当被一个驱动定义.

void (send_xchar)(struct tty_struct tty, char ch);
发送 X-类型 字符 的函数. 这个函数用来发送一个高优先级 XON 或者 XOFF 字符给 tty 设备. 要被发送的字符在 ch 变量中指定.

int (read_proc)(char page, char *start, off_t off, int count, int eof, void data);int (write_proc)(struct file file, const char buffer, unsigned long count, void *data);
/proc 读和写函数.

int (tiocmget)(struct tty_struct tty, struct file *file);
获得当前的特定 tty 设备的线路设置. 如果从 tty 设备成功获取到, 应当返回这个值给调用者.

int (tiocmset)(struct tty_struct tty, struct file *file, unsigned int set, unsigned int clear);
设置当前的特定 tty 设备的线路设置. set 和 clear 包含了去设置或者清除的不同的线路设置.