18.7. tty_operaions 結構的細節 · Linux 設備驅動 (第三版)

## 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 包含了去設置或者清除的不同的線路設置.