.TH SHOWKEY 1 "09 Oct 1997" "Console tools" "Linux User's Manual"

.SH NAME
showkey \- 檢查來自鍵盤的掃描碼和鍵盤碼

.SH "總覽 (SYNOPSIS)"
.BI "showkey [ -[" hVskm "] | " --help " | " --version " | " --scancodes
.BI "| " --keycodes " | " --keymap " ] [ " -t " N | " --timeout= "N ]"

.SH "描述 (DESCRIPTION)"
.PP
按下/鬆開 任一個 鍵 時, 
.B showkey
在 標準輸出 顯示 對應的 掃描碼(scan code), 鍵盤碼(keycode), 或者 字符值. 
如果 連續 10 秒鐘 沒發生 按下/鬆開 按鍵 事件 (該值 可用
.I --timeout
或 
.I -t
設置), 本程序 自動 結束. 來自 其他進程 的 某些 信號 也可以 結束 程序,
例如 SIGTERM.

.B showkey
有 三種 操作模式, 顯示 掃描碼, 鍵盤碼, 以及 測試 鍵盤映射(keymap),
可以 通過 命令行選項 選擇 操作模式.

.SH "命令 (COMMAND)"
.TP
.I \-h, \-\-help
.B showkey
在 標準錯誤 上 顯示 版本號, 簡短 的 用法, 然後 結束.

.TP
.I \-V, \-\-version
.B showkey
在 標準錯誤 上 顯示 版本號, 然後 結束.

.TP
.I \-s, \-\-scancodes
顯示 掃描碼.

在 這個模式 下,
.B showkey
以 十六進制數 形式 顯示 來自 鍵盤 的 每個 字節. 如果 兩個 字節 間隔
達到 0.1 秒, 或者 接收緩衝 已滿, showkey 就 輸出 一個 換行符.
可以 用它 大致 確定 某個鍵 按下 時, 鍵盤 輸出 什麼 字節序列.
掃描碼模式 主要 用來 調試 鍵盤驅動程序, 或者 其他 類似的 低層 接口.
終端用戶 對它 不太有 興趣.

.TP
.I \-k, \-\-keycodes
顯示 鍵盤碼. 這是 缺省模式.

在 這個模式 下,
.B showkey
顯示 每個鍵 按下 或 鬆開 時 對應的 鍵盤碼.
鍵盤碼 是 內核 分配給 每個 物理 按鍵 的 數值. 無論 鍵盤 輸出 單個 還是
多個 掃描碼, 每個 按鍵 只能 對應 一個 鍵盤碼. 使用 這個模式, 當 用戶 製作
自己的 鍵盤映射文件 時,
.B showkey
能夠 查出 所需的 數值.

.TP
.I \-m, \-\-keymap
顯示 鍵盤映射.

在 這個模式 下,
.B showkey
顯示 內核 根據 當前 鍵盤映射表 翻譯 出來 的 字符.
它 可能 對 安裝程序 的 作者 有用, 允許 用戶 在 確認 安裝 前 測試 新的 鍵盤.

.SH "選項 (OPTION)"
.TP
.I \-t N,  \-\-timeout=N
這個選項 用於 修改 超時值 (單位爲秒), 取代 預設的 10 秒.

.SH "作者 (AUTHOR)"
.B Showkey
是 Risto Kankkunen 爲 kbd-0.81 開發的.
.PP
後來 Yann Dirson <dirson@debian.org> 做了 擴展, 使它 能夠 支持
.I --keymap
命令 和
.I --timeout
選項.

.SH BUGS
.I --keymap
模式 應該 報告 動作鍵 (action key) 能夠 執行 什麼 動作, 而不是
執行 這些 動作.

.SH "另見 (SEE ALSO)"
.BR loadkeys (1),
.BR dumpkeys (1),
.BR keymaps (5).

.SH "[中文版維護人]"
.B 徐明 <xuming@users.sourceforge.net>
.SH "[中文版最新更新]"
.BR 2003/05/13
.SH "《中國Linux論壇man手冊頁翻譯計劃》"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR