dumpkeys 中文man页面

名称 (NAME)

dumpkeys - 转储显示键盘翻译表

总览 (SYNOPSIS)

dumpkeys [ -hilfn1 -Sshape -ccharset --help --short-info --long-info --numeric --full-table --separate-lines --shape=shape --funcs-only --keys-only --compose-only --charset=charset ]

描述 (DESCRIPTION)

dumpkeys 以 keymaps(5) 中 描述 的 格式, 在 标准输出 显示 键盘驱动程序 翻译表 的 当前内容.

下面 提供了 多种 选项, 可以 控制 输出格式, 也可以 显示 来自 内核 或 dumpkeys(1) 和 loadkeys(1) 的 其他信息.

选项 (OPTION)

-h --help

在 标准错误 上 显示 版本号 和 简短 的 用法, 然后 结束.

-i --short-info

显示 内核 键盘驱动程序 的 某些 特征:

内核 支持的 键值(keycode) 范围:

这个特征指, 在 键盘映射文件 中, keycode 关键字 后面 可以 使用 什么值. 有关 这个文件 的 语法 和 其他信息 参看 keymaps(5).

单键 可编联(bind) 的 动作(action) 数:

这个特征指, 通过 修饰键 的 组合, 一个键 能够 发生 多少个 不同的 动作. 例如, 如果 该值是 16, 那么 一个键 结合 修饰键 可以 产生 多达 16 个 动作. 此时, 内核 大约 知道 存在 四个 修饰键, 你可以 按下 不同的 修饰键 组合 获得 所有 定义的 动作.

内核 支持的 动作码(action code) 值域(range):

这一项 包含 用 十六进制 表示的 动作码 值域. 这些值 能够 用在 按键定义 的 右边, 也就是 下面 这行 的 vv 部分:

keycode xx = vv vv vv vv

(有关 按键定义行 的 细节 参见 keymaps(5) ). dumpkeys(1) 和 loadkeys(1) 支持 符号表示法, 它 比 数字表示法 更优越, 内核 和 内核 之间的 动作码 可能不一样, 而 符号名字 一般 不变. 然而, 动作码值域 列表 可以 用来 判断 内核 是否 支持 loadkeys(1) 识别的 全部 符号, 或者 内核 支持的 动作 在 loadkeys(1) 中 有没有 对应的 符号名. 你 可以 比较一下 值域列表 和 动作符号表, 参见 下述的 --long-info 选项.

内核 支持的 功能键(function key) 数目:

这个特征 指 能够 用来 输出 字符串 的 动作码 数目. 这些 动作码 往往 编联 键盘上的 功能键 和 编辑键, 输出 标准 escape 序列. 然而 你 可以 重定义 这些键, 让 它们 输出 命令行, 电子邮件地址 或者 其他什么. 特别是 某些 编号 的 功能键 和 编辑键 在 键盘上 不存在, 这样 就有了 "空闲的" 动作码, 例如, 把 它们 和 AltGr-字母组合 编联, 用来 输出 有用的 字符串. 详情 参见 loadkeys(1).

功能串(function string):

可以 用 下面的 命令 查看 当前 的 功能键 定义

dumpkeys --funcs-only

-l --long-info

这个选项 要求 dumpkeys 显示 较多的 信息. 显示 的 信息 除了 --short-info 选项 的 内容 外, 增加了 loadkeys(1) 和 dumpkeys(1) 支持 的 动作 的 符号名 列表, 及 对应的 数值.

-n --numeric

这个选项 阻止 dumpkeys 把 动作码 翻译成 符号名, 只 显示 十六进制数字.

-f --full-table

这个选项 使 dumpkeys 跳过 所有 速记形式(short-hand) (参见 keymaps(5)), 以 行排格式(canonical) 输出 键值编联. 首先是 keymaps 行, 描述 当前 定义的 修饰键 及其 组合. 然后 每个键 显示 一行, 其中 每个 修饰键 的 组合 占 一列. 例如, 如果 键盘映射表 使用了 七个 修饰键组合, 那么 每行 将显示 七列动作码. 这种格式 用于 诸如 对 dumpkeys 输出 的 后处理 等.

-1 --separate-lines

这个选项 使 dumpkeys 把 每个 (修饰键,键值)对 用 一行 显示. 前缀 plain 表示 没有 使用 修饰键.

-S --shape=shape

这个选项 告诉 dumpkeys 使用 指定的 表格格式. 允许的 表格格式 有 0: 缺省格式 (就象 没使用 -S 一样); 1: 和 使用 选项 --full-table 一样; 2: 和 使用 选项 --separate-lines 一样; 3: 每个 键值 占用 一行 (就象 格式 1 一样), 直到 遇到 ***个 空项(hole), 然后 每个 (修饰键,键值)对 一行 (就象 格式 2 一样).

(译注: 空项 位置 可参考 dumpkeys 不带参数时 显示的 ***行, keymaps 行)

--funcs-only

这个选项 使 dumpkeys 只显示 功能键 定义的 字符串. 否则 dumpkeys 既显示 串定义, 也显示 键值编联.

--keys-only

这个选项 使 dumpkeys 只显示 键值编联. 否则 dumpkeys 既显示 串定义, 也显示 键值编联.

--compose-only

这个选项 使 dumpkeys 只显示 组合键(compose key) 定义. 它 只对 支持 组合键 的 内核 有效.

-ccharset --charset=charset

这个选项 使 dumpkeys 根据 指定的 字符集 翻译 字符码值. 它 只影响 字符码值 对 符号名 的 翻译. 用 --help 选项 可以 列出 charset 的 有效值. 如果 没有 指定 charset, 缺省字符集 是 iso-8859-1. 这个选项 能够 输出 一个 `charset "iso-8859-X"' 行, 告诉 loadkeys 如何 翻译键盘映射表. (例如, "division" 在 iso-8859-1 中 是 0xf7, 但在 iso-8859-8 中 是 0xba).

文件 (FILE)

/usr/lib/kbd/keymaps/ 推荐 存放 键盘映射 文件 的 目录.

另见 (SEE ALSO)

loadkeys(1), keymaps(5).

#p#

NAME

dumpkeys - dump keyboard translation tables  

SYNOPSIS

dumpkeys [ -hilfn -ccharset --help --short-info --long-info --numeric --full-table --funcs-only --keys-only --compose-only --charset=charset ]  

DESCRIPTION

dumpkeys writes, to the standard output, the current contents of the keyboard driver's translation tables, in the format specified by keymaps(5).

Using the various options, the format of the output can be controlled and also other information from the kernel and the programs dumpkeys(1) and loadkeys(1) can be obtained.  

OPTIONS

-h --help

Prints the program's version number and a short usage message to the program's standard error output and exits.

-i --short-info

Prints some characteristics of the kernel's keyboard driver. The items shown are:

Keycode range supported by the kernel

This tells what values can be used after the keycode keyword in keytable files. See keymaps(5) for more information and the syntax of these files.

Number of actions bindable to a key

This tells how many different actions a single key can output using various modifier keys. If the value is 16 for example, you can define up to 16 different actions to a key combined with modifiers. When the value is 16, the kernel probably knows about four modifier keys, which you can press in different combinations with the key to access all the bound actions.

Ranges of action codes supported by the kernel

This item contains a list of action code ranges in hexadecimal notation. These are the values that can be used in the right hand side of a key definition, ie. the vv's in a line

keycode xx = vv vv vv vv

(see keymaps(5) for more information about the format of key definition lines). dumpkeys(1) and loadkeys(1) support a symbolic notation, which is preferable to the numeric one, as the action codes may vary from kernel to kernel while the symbolic names usually remain the same. However, the list of action code ranges can be used to determine, if the kernel actually supports all the symbols loadkeys(1) knows, or are there maybe some actions supported by the kernel that have no symbolic name in your loadkeys(1) program. To see this, you compare the range list with the action symbol list, see option --long-info below.

Number of function keys supported by kernel

This tells the number of action codes that can be used to output strings of characters. These action codes are traditionally bound to the various function and editing keys of the keyboard and are defined to send standard escape sequences. However, you can redefine these to send common command lines, email addresses or whatever you like. Especially if the number of this item is greater than the number of function and editing keys in your keyboard, you may have some "spare" action codes that you can bind to AltGr-letter combinations, for example, to send some useful strings. See loadkeys(1) for more details.

Function strings

You can see you current function key definitions with the command

dumpkeys --funcs-only

-l --long-info

This option instructs dumpkeys to print a long information listing. The output is the same as with the --short-info appended with the list of action symbols supported by loadkeys(1) and dumpkeys(1), along with the symbols' numeric values.

-n --numeric

This option causes dumpkeys to by-pass the conversion of action code values to symbolic notation and to print the in hexadecimal format instead.

-f --full-table

This makes dumpkeys skip all the short-hand heuristics (see keymaps(5)) and output the key bindings in the canonical form. First a keymaps line describing the currently defined modifier combinations is printed. Then for each key a row with a column for each modifier combination is printed. For example, if the current keymap in use uses seven modifiers, every row will have seven action code columns. This format can be useful for example to programs that post-process the output of dumpkeys.

--funcs-only

When this option is given, dumpkeys prints only the function key string definitions. Normally dumpkeys prints both the key bindings and the string definitions.

--keys-only

When this option is given, dumpkeys prints only the key bindings. Normally dumpkeys prints both the key bindings and the string definitions.

--compose-only

When this option is given, dumpkeys prints only the compose key combinations. This option is available only if your kernel has compose key support.

-ccharset --charset=charset

This instructs dumpkeys to interpret character code values according to the specified character set. This affects only the translation of character code values to symbolic names. Valid values for charset currently are iso-8859-X, Where X is a digit in 1-9. If no charset is specified, iso-8859-1 is used as a default. This option produces an output line `charset "iso-8859-X"', telling loadkeys how to interpret the keymap. (For example, "division" is 0xf7 in iso-8859-1 but 0xba in iso-8859-8.)

FILES

/lib/kbd/keymaps

recommended directory for keytable files

SEE ALSO

loadkeys(1), keymaps(5)