Imported upstream version 1.5
[manpages-zh.git] / src / man1 / dumpkeys.1
blobfcd53bb8aeaa3ad626ae8498803339c5a37a507f
1 .TH DUMPKEYS 1 "09 Oct 1997" "Console tools" "Linux User's Manual"
3 .SH NAME
4 dumpkeys \- 转储显示键盘翻译表
6 .SH "总览 (SYNOPSIS)"
7 .B dumpkeys [
8 .I \-hilfn1
9 .IB \-S shape
10 .IB \-c charset
11 .I \-\-help \-\-short\-info \-\-long\-info \-\-numeric \-\-full\-table
12 .I \-\-separate\-lines 
13 .IB \-\-shape= shape
14 .I \-\-funcs\-only \-\-keys\-only \-\-compose\-only
15 .IB \-\-charset= charset
16 .B ]
18 .SH "描述 (DESCRIPTION)"
19 .IX "dumpkeys command" "" "\fLdumpkeys\fR command"  
21 .B dumpkeys
22
23 .BR keymaps (5)
24 中 描述 的 格式, 在 标准输出 显示 键盘驱动程序 翻译表 的 当前内容.
25 .PP
26 下面 提供了 多种 选项, 可以 控制 输出格式, 也可以 显示 来自 内核 或
27 .BR dumpkeys (1)
28
29 .BR loadkeys (1)
30 的 其他信息.
32 .SH "选项 (OPTION)"
33 .TP
34 .I \-h \-\-help
35 在 标准错误 上 显示 版本号 和 简短 的 用法, 然后 结束.
37 .TP
38 .I \-i \-\-short-info
39 显示 内核 键盘驱动程序 的 某些 特征:
41 .RS
42 内核 支持的 键值(keycode) 范围:
43 .PP
44 .RS
45 这个特征指, 在 键盘映射文件 中, 
46 .B keycode
47 关键字 后面 可以 使用 什么值. 有关 这个文件 的 语法 和 其他信息 参看
48 .BR keymaps (5).
49 .RE
51 单键 可编联(bind) 的 动作(action) 数:
52 .PP
53 .RS
54 这个特征指, 通过 修饰键 的 组合, 一个键 能够 发生 多少个 不同的 动作.
55 例如, 如果 该值是 16, 那么 一个键 结合 修饰键 可以 产生 多达 16 个 动作.
56 此时, 内核 大约 知道 存在 四个 修饰键, 你可以 按下 不同的 修饰键 组合 获得 
57 所有 定义的 动作.
58 .RE
60 内核 支持的 动作码(action code) 值域(range):
61 .PP
62 .RS
63 这一项 包含 用 十六进制 表示的 动作码 值域. 这些值 能够 
64 用在 按键定义 的 右边, 也就是 下面 这行 的 
65 .IR vv 
66 部分:
68 .RS
69 .B keycode
70 .I xx
72 .I vv vv vv vv
73 .RE
75 (有关 按键定义行 的 细节 参见
76 .BR keymaps (5)
78 .BR dumpkeys (1)
79
80 .BR loadkeys (1)
81 支持 符号表示法, 它 比 数字表示法 更优越, 内核 和 内核 之间的 动作码 可能
82 不一样, 而 符号名字 一般 不变.
83 然而, 动作码值域 列表 可以 用来 判断 内核 是否 支持 
84 .BR loadkeys (1)
85 识别的 全部 符号, 或者 内核 支持的 动作 在
86 .BR loadkeys (1)
87 中 有没有 对应的 符号名. 你 可以 比较一下 值域列表 和 动作符号表, 参见 下述的
88 .I --long-info
89 选项.
90 .RE
92 内核 支持的 功能键(function key) 数目:
93 .PP
94 .RS
95 这个特征 指 能够 用来 输出 字符串 的 动作码 数目. 
96 这些 动作码 往往 编联 键盘上的 功能键 和 编辑键, 输出 标准 escape 序列.
97 然而 你 可以 重定义 这些键, 让 它们 输出 命令行, 电子邮件地址 或者 其他什么.
98 特别是 某些 编号 的 功能键 和 编辑键 在 键盘上 不存在, 这样 就有了 "空闲的"
99 动作码, 例如, 把 它们 和 AltGr-字母组合 编联, 用来 输出 有用的 字符串.
100 详情 参见
101 .BR loadkeys (1).
104 功能串(function string):
107 可以 用 下面的 命令 查看 当前 的 功能键 定义
110 .BI dumpkeys \ \-\-funcs\-only
116 .I \-l \-\-long-info
117 这个选项 要求
118 .B dumpkeys
119 显示 较多的 信息. 显示 的 信息 除了
120 .I --short-info
121 选项 的 内容 外, 增加了
122 .BR loadkeys (1)
124 .BR dumpkeys (1)
125 支持 的 动作 的 符号名 列表, 及 对应的 数值.
128 .I \-n \-\-numeric
129 这个选项 阻止
130 .B dumpkeys
131 把 动作码 翻译成 符号名, 只 显示 十六进制数字.
134 .I \-f \-\-full-table
135 这个选项 使
136 .B dumpkeys
137 跳过 所有 速记形式(short-hand) (参见
138 .BR keymaps (5)),
139 以 行排格式(canonical) 输出 键值编联. 首先是 keymaps 行, 描述 当前 定义的 
140 修饰键 及其 组合. 然后 每个键 显示 一行, 其中 每个 修饰键 的 组合 占 一列.
141 例如, 如果 键盘映射表 使用了 七个 修饰键组合, 那么 每行 将显示 七列
142 动作码. 这种格式 用于 诸如 对
143 .BR dumpkeys 
144 输出 的 后处理 等.
147 .I \-1 \-\-separate\-lines
148 这个选项 使
149 .B dumpkeys
150 把 每个 (修饰键,键值)对 用 一行 显示. 前缀 
151 .I plain
152 表示 没有 使用 修饰键.
155 .IB "\-S \-\-shape=" shape
156 这个选项 告诉
157 .B dumpkeys
158 使用 指定的 表格格式. 允许的 表格格式 有
159 .BI 0 :
160 缺省格式 (就象 没使用
161 .IR \-S 
162 一样);
163 .BR 1 :
164 和 使用 选项
165 .IR \-\-full\-table 
166 一样;
167 .BR 2 :
168 和 使用 选项
169 .IR \-\-separate\-lines 
170 一样;
171 .BR 3 :
172 每个 键值 占用 一行 (就象 格式
173 .BR 1 
174 一样), 直到 遇到 第一个 空项(hole), 然后 每个 (修饰键,键值)对 一行
175 (就象 格式
176 .BR 2 
177 一样).
179 (译注: 空项 位置 可参考 dumpkeys 不带参数时 显示的 第一行, keymaps 行)
182 .I \-\-funcs-only
183 这个选项 使
184 .B dumpkeys
185 只显示 功能键 定义的 字符串. 否则
186 .B dumpkeys
187 既显示 串定义, 也显示 键值编联.
190 .I \-\-keys-only
191 这个选项 使
192 .B dumpkeys
193 只显示 键值编联. 否则
194 .B dumpkeys
195 既显示 串定义, 也显示 键值编联.
198 .I \-\-compose-only
199 这个选项 使
200 .B dumpkeys
201 只显示 组合键(compose key) 定义. 它 只对 支持 组合键 的 内核 有效.
204 .IB \-c "charset " \-\-charset= charset
205 这个选项 使
206 .B dumpkeys
207 根据 指定的 字符集 翻译 字符码值. 它 只影响 字符码值 对 符号名 的 翻译. 用
208 .I \-\-help
209 选项 可以 列出 
210 .I charset
211 的 有效值. 如果 没有 指定
212 .I charset,
213 缺省字符集 是
214 .B iso-8859-1.
215 这个选项 能够 输出 一个 `charset "iso-8859-X"' 行, 告诉 loadkeys 如何 翻译
216 键盘映射表. (例如, "division" 在
217 .B iso-8859-1
218 中 是 0xf7, 但在
219 .BR iso-8859-8 
220 中 是 0xba).
222 .SH "文件 (FILE)"
223 .I /usr/lib/kbd/keymaps/
224 推荐 存放 键盘映射 文件 的 目录.
226 .SH "另见 (SEE ALSO)"
227 .BR loadkeys (1),
228 .BR keymaps (5).
230 .SH "[中文版维护人]"
231 .B 徐明 <xuming@iname.com>
232 .SH "[中文版最新更新]"
233 .BR 2001/12/10
234 第一版
235 .SH "《中国Linux论坛man手册页翻译计划》:"
236 .BI http://cmpp.linuxforum.net