|
Packit |
ec106e |
.\" @(#)loadkeys.1 1.0 93/09/1 RK
|
|
Packit |
ec106e |
.TH DUMPKEYS 1 "1 Sep 1993"
|
|
Packit |
ec106e |
.SH NAME
|
|
Packit |
ec106e |
dumpkeys \- dump keyboard translation tables
|
|
Packit |
ec106e |
.SH SYNOPSIS
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
[
|
|
Packit |
ec106e |
.\".B \-1Vdfhiklnstv
|
|
Packit |
ec106e |
.B \-h \-\-help \-i \-\-short\-info \-l \-s \-\-long\-info
|
|
Packit |
ec106e |
.B \-n \-\-numeric \-f \-\-full\-table \-1 \-\-separate-lines
|
|
Packit |
ec106e |
.BI \-S shape
|
|
Packit |
ec106e |
.BI \-\-shape= shape
|
|
Packit |
ec106e |
.B \-t \-\-funcs\-only \-k \-\-keys\-only \-d \-\-compose\-only
|
|
Packit |
ec106e |
.BI \-c charset
|
|
Packit |
ec106e |
.BI \-\-charset= charset
|
|
Packit |
ec106e |
.B \-v \-\-verbose \-V \-\-version
|
|
Packit |
ec106e |
]
|
|
Packit |
ec106e |
.SH DESCRIPTION
|
|
Packit |
ec106e |
.IX "dumpkeys command" "" "\fLdumpkeys\fR command"
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
writes, to the standard output, the current contents of the keyboard
|
|
Packit |
ec106e |
driver's translation tables, in the format specified by
|
|
Packit |
ec106e |
.BR keymaps (5).
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
Using the various options, the format of the output can be controlled
|
|
Packit |
ec106e |
and also other information from the kernel and the programs
|
|
Packit |
ec106e |
.BR dumpkeys (1)
|
|
Packit |
ec106e |
and
|
|
Packit |
ec106e |
.BR loadkeys (1)
|
|
Packit |
ec106e |
can be obtained.
|
|
Packit |
ec106e |
.SH OPTIONS
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-h \-\-help
|
|
Packit |
ec106e |
Prints the program's version number and a short usage message to the
|
|
Packit |
ec106e |
program's standard error output and exits.
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-i \-\-short-info
|
|
Packit |
ec106e |
Prints some characteristics of the kernel's keyboard driver. The items
|
|
Packit |
ec106e |
shown are:
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
Keycode range supported by the kernel
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
This tells what values can be used after the
|
|
Packit |
ec106e |
.B keycode
|
|
Packit |
ec106e |
keyword in keytable files. See
|
|
Packit |
ec106e |
.BR keymaps (5)
|
|
Packit |
ec106e |
for more information and the syntax of these files.
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
Number of actions bindable to a key
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
This tells how many different actions a single key can output using
|
|
Packit |
ec106e |
various modifier keys. If the value is 16 for example, you can define up
|
|
Packit |
ec106e |
to 16 different actions to a key combined with modifiers. When the value
|
|
Packit |
ec106e |
is 16, the kernel probably knows about four modifier keys, which you can
|
|
Packit |
ec106e |
press in different combinations with the key to access all the bound
|
|
Packit |
ec106e |
actions.
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
Ranges of action codes supported by the kernel
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
This item contains a list of action code ranges in hexadecimal notation.
|
|
Packit |
ec106e |
These are the values that can be used in the right hand side of a key
|
|
Packit |
ec106e |
definition, ie. the
|
|
Packit |
ec106e |
.IR vv 's
|
|
Packit |
ec106e |
in a line
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
.B keycode
|
|
Packit |
ec106e |
.I xx
|
|
Packit |
ec106e |
=
|
|
Packit |
ec106e |
.I vv vv vv vv
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
(see
|
|
Packit |
ec106e |
.BR keymaps (5)
|
|
Packit |
ec106e |
for more information about the format of key definition lines).
|
|
Packit |
ec106e |
.BR dumpkeys (1)
|
|
Packit |
ec106e |
and
|
|
Packit |
ec106e |
.BR loadkeys (1)
|
|
Packit |
ec106e |
support a symbolic notation, which is preferable to the numeric one, as
|
|
Packit |
ec106e |
the action codes may vary from kernel to kernel while the symbolic names
|
|
Packit |
ec106e |
usually remain the same. However, the list of action code ranges can be
|
|
Packit |
ec106e |
used to determine, if the kernel actually supports all the symbols
|
|
Packit |
ec106e |
.BR loadkeys (1)
|
|
Packit |
ec106e |
knows, or are there maybe some actions supported by the kernel that
|
|
Packit |
ec106e |
have no symbolic name in your
|
|
Packit |
ec106e |
.BR loadkeys (1)
|
|
Packit |
ec106e |
program. To see this, you compare the range list with the action symbol
|
|
Packit |
ec106e |
list, see option
|
|
Packit |
ec106e |
.B --long-info
|
|
Packit |
ec106e |
below.
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
Number of function keys supported by kernel
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
This tells the number of action codes that can be used to output
|
|
Packit |
ec106e |
strings of characters. These action codes are traditionally bound to
|
|
Packit |
ec106e |
the various function and editing keys of the keyboard and are defined
|
|
Packit |
ec106e |
to send standard escape sequences. However, you can redefine these to
|
|
Packit |
ec106e |
send common command lines, email addresses or whatever you like.
|
|
Packit |
ec106e |
Especially if the number of this item is greater than the number of
|
|
Packit |
ec106e |
function and editing keys in your keyboard, you may have some "spare"
|
|
Packit |
ec106e |
action codes that you can bind to AltGr-letter combinations, for example,
|
|
Packit |
ec106e |
to send some useful strings. See
|
|
Packit |
ec106e |
.BR loadkeys (1)
|
|
Packit |
ec106e |
for more details.
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
Function strings
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
You can see you current function key definitions with the command
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RS
|
|
Packit |
ec106e |
.B dumpkeys --funcs-only
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.RE
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-l \-s \-\-long-info
|
|
Packit |
ec106e |
This option instructs
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
to print a long information listing. The output is the same as with the
|
|
Packit |
ec106e |
.B --short-info
|
|
Packit |
ec106e |
appended with the list of action symbols supported by
|
|
Packit |
ec106e |
.BR loadkeys (1)
|
|
Packit |
ec106e |
and
|
|
Packit |
ec106e |
.BR dumpkeys (1),
|
|
Packit |
ec106e |
along with the symbols' numeric values.
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-n \-\-numeric
|
|
Packit |
ec106e |
This option causes
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
to by-pass the conversion of action code values to symbolic notation and
|
|
Packit |
ec106e |
to print the in hexadecimal format instead.
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-f \-\-full-table
|
|
Packit |
ec106e |
This makes
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
skip all the short-hand heuristics (see
|
|
Packit |
ec106e |
.BR keymaps (5))
|
|
Packit |
ec106e |
and output the key bindings in the canonical form. First a keymaps
|
|
Packit |
ec106e |
line describing the currently defined modifier combinations
|
|
Packit |
ec106e |
is printed. Then for each key a row with a column for each
|
|
Packit |
ec106e |
modifier combination is printed. For
|
|
Packit |
ec106e |
example, if the current keymap in use uses seven modifiers,
|
|
Packit |
ec106e |
every row will have seven action code columns. This format
|
|
Packit |
ec106e |
can be useful for example to programs that post-process the
|
|
Packit |
ec106e |
output of
|
|
Packit |
ec106e |
.BR dumpkeys .
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.BI \-S shape " " " " \-\-shape= shape
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit Service |
f9c5e1 |
.B \-1 \-\-separate-lines
|
|
Packit Service |
f9c5e1 |
This forces
|
|
Packit Service |
f9c5e1 |
.B dumpkeys
|
|
Packit Service |
f9c5e1 |
to write one line per (modifier,keycode) pair. It prefixes the word
|
|
Packit Service |
f9c5e1 |
.I plain
|
|
Packit Service |
f9c5e1 |
for plain keycodes.
|
|
Packit Service |
f9c5e1 |
.LP
|
|
Packit Service |
f9c5e1 |
.TP
|
|
Packit |
ec106e |
.B \-t \-\-funcs-only
|
|
Packit |
ec106e |
When this option is given,
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
prints only the function key string definitions. Normally
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
prints both the key bindings and the string definitions.
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-k \-\-keys-only
|
|
Packit |
ec106e |
When this option is given,
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
prints only the key bindings. Normally
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
prints both the key bindings and the string definitions.
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-d \-\-compose-only
|
|
Packit |
ec106e |
When this option is given,
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
prints only the compose key combinations.
|
|
Packit |
ec106e |
This option is available only if your kernel has compose key support.
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.BI \-c charset " " " " \-\-charset= charset
|
|
Packit |
ec106e |
This instructs
|
|
Packit |
ec106e |
.B dumpkeys
|
|
Packit |
ec106e |
to interpret character code values according to the specified character
|
|
Packit |
ec106e |
set. This affects only the translation of character code values to
|
|
Packit |
ec106e |
symbolic names. Valid values for
|
|
Packit |
ec106e |
.I charset
|
|
Packit |
ec106e |
currently are
|
|
Packit |
ec106e |
.BR iso-8859-X ,
|
|
Packit |
ec106e |
Where X is a digit in 1-9. If no
|
|
Packit |
ec106e |
.I charset
|
|
Packit |
ec106e |
is specified,
|
|
Packit |
ec106e |
.B iso-8859-1
|
|
Packit |
ec106e |
is used as a default.
|
|
Packit |
ec106e |
This option produces an output line `charset "iso-8859-X"', telling
|
|
Packit |
ec106e |
loadkeys how to interpret the keymap. (For example, "division" is
|
|
Packit |
ec106e |
0xf7 in iso-8859-1 but 0xba in iso-8859-8.)
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-v \-\-verbose
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.TP
|
|
Packit |
ec106e |
.B \-V \-\-version
|
|
Packit |
ec106e |
Prints version number and exits.
|
|
Packit |
ec106e |
.LP
|
|
Packit |
ec106e |
.SH FILES
|
|
Packit |
ec106e |
.PD 0
|
|
Packit |
ec106e |
.TP 20
|
|
Packit |
ec106e |
.BI @DATADIR@/keymaps
|
|
Packit |
ec106e |
recommended directory for keytable files
|
|
Packit |
ec106e |
.PD
|
|
Packit |
ec106e |
.SH "SEE ALSO"
|
|
Packit |
ec106e |
.BR loadkeys (1),
|
|
Packit |
ec106e |
.BR keymaps (5)
|
|
Packit |
ec106e |
|