NAME

itemap − Load an ITE (Internal Terminal Emulator) keyboard mapping. 

SYNOPSIS

itemap [ options]

DESCRIPTION

itemap loads a keyboard mapping into the ITE (the graphics console driver), or displays ITE keyboard mappings.  itemap is run by /etc/rc automatically.  It is not usually explicitly invoked by the user. 

Options

-d name or keyboard_ID
Dump a keymap to standard output in hexadecimal notation.

-h Load the specified keymap into the kernel mapping table used for HP-HIL keyboards. 

-i Interactively prompt for a PS2 DIN keyboard mapping.  itemap scans the keymap database file for all mapping names beginning with a PS2_DIN prefix.  Each of these names is displayed, and one must be selected. 

-k database_file_name
The name of the keymap database file to be used for input. The default is /usr/lib/X11/XHPKeymaps. 

-L Load the appropriate keymap.  itemap scans the hardware for a keyboard, determines the language of that keyboard, and loads the keymap corresponding to that keyboard. 
 
Because itemap cannot determine the language of PS2 DIN keyboards, use the -i option when using -L with PS2 DIN keyboards. 

-l name or keyboard_ID
Load a specified keyboard map.  Once loaded, ITE uses the specified mapping.

When loading a keyboard mapping with the -l option, itemap matches the suffix of the name of the specified keyboard mapping with those found in /usr/lib/X11/XHPKeymaps to determine the keyboard language. This information is used by the ITE to perform ISO 7-to-8 bit conversion.  Keymap names added by users (via /usr/contrib/bin/X11/keymap_ed) should use the same suffixes as those already used in /usr/lib/X11/XHPKeymaps.  For example, a French keyboard mapping can be named New_French, for consistency with existing ITF_French and PS2_French mappings.  A mapping called New_Stuff would not match any suffix patterns found by itemap, and would result in incorrect ISO 7-to-8 bit conversion. 

-p Load the specified keymap into the kernel mapping table used for PS2 DIN keyboards. 

-v Perform actions verbosely. 

-w file_name
If a keymap for a PS2 DIN keyboard is loaded, write its name to file_name. 

EXAMPLES

To automatically install the correct mapping for an HP-HIL keyboard:

itemap -L

To explicitly load the ITF_French mapping for an HP-HIL keyboard:

itemap -h -l ITF_French

To explicitly load the PS2_DIN_French mapping for a PS2 DIN keyboard:

itemap -p -l PS2_DIN_French

To interactively choose a PS2 DIN keyboard mapping:

itemap -Li

To generate a list of the available keyboard mappings:

/usr/contrib/bin/X11/keymap_ed -l

FILES

/usr/contrib/bin/X11/keymap_ed keymap database editor

/usr/lib/X11/XHPKeymaps system keymap database

/etc/kbdlang contains mapping name configured for PS2 DIN keyboards

SEE ALSO

termio(7), ps2(7), x11/keymap_ed.html">keymap_ed(1X11)

  —  April 21, 1994