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

.SH NAME
dumpkeys \- 轉儲顯示鍵盤翻譯表

.SH "總覽 (SYNOPSIS)"
.B dumpkeys [
.I \-hilfn1
.IB \-S shape
.IB \-c charset
.I \-\-help \-\-short\-info \-\-long\-info \-\-numeric \-\-full\-table
.I \-\-separate\-lines 
.IB \-\-shape= shape
.I \-\-funcs\-only \-\-keys\-only \-\-compose\-only
.IB \-\-charset= charset
.B ]

.SH "描述 (DESCRIPTION)"
.B dumpkeys
以
.BR keymaps (5)
中 描述 的 格式, 在 標準輸出 顯示 鍵盤驅動程式 翻譯表 的 當前內容.
.PP
下面 提供了 多種 選項, 可以 控制 輸出格式, 也可以 顯示 來自 核心 或
.BR dumpkeys (1)
和
.BR loadkeys (1)
的 其他資訊.

.SH "選項 (OPTION)"
.TP
.I \-h \-\-help
在 標準錯誤 上 顯示 版本號 和 簡短 的 用法, 然後 結束.

.TP
.I \-i \-\-short-info
顯示 核心 鍵盤驅動程式 的 某些 特徵:

.RS
核心 支援的 鍵值(keycode) 範圍:
.PP
.RS
這個特徵指, 在 鍵盤對映檔案 中, 
.B keycode
關鍵字 後面 可以 使用 什麼值. 有關 這個檔案 的 語法 和 其他資訊 參看
.BR keymaps (5).
.RE

單鍵 可編聯(bind) 的 動作(action) 數:
.PP
.RS
這個特徵指, 透過 修飾鍵 的 組合, 一個鍵 能夠 發生 多少個 不同的 動作.
例如, 如果 該值是 16, 那麼 一個鍵 結合 修飾鍵 可以 產生 多達 16 個 動作.
此時, 核心 大約 知道 存在 四個 修飾鍵, 你可以 按下 不同的 修飾鍵 組合 獲得 
所有 定義的 動作.
.RE

核心 支援的 動作碼(action code) 值域(range):
.PP
.RS
這一項 包含 用 十六進位制 表示的 動作碼 值域. 這些值 能夠 
用在 按鍵定義 的 右邊, 也就是 下面 這行 的 
.IR vv 
部分:

.RS
.B keycode
.I xx
=
.I vv vv vv vv
.RE

(有關 按鍵定義行 的 細節 參見
.BR keymaps (5)
).
.BR dumpkeys (1)
和
.BR loadkeys (1)
支援 符號表示法, 它 比 數字表示法 更優越, 核心 和 核心 之間的 動作碼 可能
不一樣, 而 符號名字 一般 不變.
然而, 動作碼值域 列表 可以 用來 判斷 核心 是否 支援 
.BR loadkeys (1)
識別的 全部 符號, 或者 核心 支援的 動作 在
.BR loadkeys (1)
中 有沒有 對應的 符號名. 你 可以 比較一下 值域列表 和 動作符號表, 參見 下述的
.I --long-info
選項.
.RE

核心 支援的 功能鍵(function key) 數目:
.PP
.RS
這個特徵 指 能夠 用來 輸出 字串 的 動作碼 數目. 
這些 動作碼 往往 編聯 鍵盤上的 功能鍵 和 編輯鍵, 輸出 標準 escape 序列.
然而 你 可以 重定義 這些鍵, 讓 它們 輸出 命令列, 電子郵件地址 或者 其他什麼.
特別是 某些 編號 的 功能鍵 和 編輯鍵 在 鍵盤上 不存在, 這樣 就有了 "空閒的"
動作碼, 例如, 把 它們 和 AltGr-字母組合 編聯, 用來 輸出 有用的 字串.
詳情 參見
.BR loadkeys (1).
.RE

功能串(function string):
.PP
.RS
可以 用 下面的 命令 檢視 當前 的 功能鍵 定義

.RS
.BI dumpkeys \ \-\-funcs\-only
.RE
.RE
.RE

.TP
.I \-l \-\-long-info
這個選項 要求
.B dumpkeys
顯示 較多的 資訊. 顯示 的 資訊 除了
.I --short-info
選項 的 內容 外, 增加了
.BR loadkeys (1)
和
.BR dumpkeys (1)
支援 的 動作 的 符號名 列表, 及 對應的 數值.

.TP
.I \-n \-\-numeric
這個選項 阻止
.B dumpkeys
把 動作碼 翻譯成 符號名, 只 顯示 十六進位制數字.

.TP
.I \-f \-\-full-table
這個選項 使
.B dumpkeys
跳過 所有 速記形式(short-hand) (參見
.BR keymaps (5)),
以 行排格式(canonical) 輸出 鍵值編聯. 首先是 keymaps 行, 描述 當前 定義的 
修飾鍵 及其 組合. 然後 每個鍵 顯示 一行, 其中 每個 修飾鍵 的 組合 佔 一列.
例如, 如果 鍵盤對映表 使用了 七個 修飾鍵組合, 那麼 每行 將顯示 七列
動作碼. 這種格式 用於 諸如 對
.BR dumpkeys 
輸出 的 後處理 等.

.TP
.I \-1 \-\-separate\-lines
這個選項 使
.B dumpkeys
把 每個 (修飾鍵,鍵值)對 用 一行 顯示. 字首 
.I plain
表示 沒有 使用 修飾鍵.

.TP
.IB "\-S \-\-shape=" shape
這個選項 告訴
.B dumpkeys
使用 指定的 表格格式. 允許的 表格格式 有
.BI 0 :
預設格式 (就象 沒使用
.IR \-S 
一樣);
.BR 1 :
和 使用 選項
.IR \-\-full\-table 
一樣;
.BR 2 :
和 使用 選項
.IR \-\-separate\-lines 
一樣;
.BR 3 :
每個 鍵值 佔用 一行 (就象 格式
.BR 1 
一樣), 直到 遇到 第一個 空項(hole), 然後 每個 (修飾鍵,鍵值)對 一行
(就象 格式
.BR 2 
一樣).

(譯註: 空項 位置 可參考 dumpkeys 不帶引數時 顯示的 第一行, keymaps 行)

.TP
.I \-\-funcs-only
這個選項 使
.B dumpkeys
只顯示 功能鍵 定義的 字串. 否則
.B dumpkeys
既顯示 串定義, 也顯示 鍵值編聯.

.TP
.I \-\-keys-only
這個選項 使
.B dumpkeys
只顯示 鍵值編聯. 否則
.B dumpkeys
既顯示 串定義, 也顯示 鍵值編聯.

.TP
.I \-\-compose-only
這個選項 使
.B dumpkeys
只顯示 組合鍵(compose key) 定義. 它 只對 支援 組合鍵 的 核心 有效.

.TP
.IB \-c "charset " \-\-charset= charset
這個選項 使
.B dumpkeys
根據 指定的 字符集 翻譯 字元碼值. 它 隻影響 字元碼值 對 符號名 的 翻譯. 用
.I \-\-help
選項 可以 列出 
.I charset
的 有效值. 如果 沒有 指定
.I charset,
預設字符集 是
.B iso-8859-1.
這個選項 能夠 輸出 一個 `charset "iso-8859-X"' 行, 告訴 loadkeys 如何 翻譯
鍵盤對映表. (例如, "division" 在
.B iso-8859-1
中 是 0xf7, 但在
.BR iso-8859-8 
中 是 0xba).

.SH "檔案 (FILE)"
.I /usr/lib/kbd/keymaps/
推薦 存放 鍵盤對映 檔案 的 目錄.

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

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