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