mapkey(1M)                                                       mapkey(1M)

NAME
     mapkey, mapscrn, mapstr - configure monitor screen mapping

SYNOPSIS
     mapkey [-doxV] [datafile]

     mapscrn [-dg] [datafile]

     mapstr [-dg] [datafile]

DESCRIPTION
     mapscrn configures the output mapping of the virtual terminal screen
     on which it is invoked and can thus be applied only to the console.
     mapkey and mapstr configure the mapping of the keyboard and string
     keys (for example, function keys) of a device. In the case of the con-
     sole the device is the virtual terminal (VT), otherwise it is an
     alphanumeric terminal (e.g. TC20-V100).

     mapscrn and mapstr function on a per-device basis. Mapping on one
     device does not affect any other device. Setting the default for every
     device can be done using the -g option. The -g option may be used only
     by the privileged user.

     The mapscrn command sets up a one-to-one character mapping on output.
     This is also known as the "screen mapping" capability. A screen map is
     an array of 256 bytes (eight-bit characters). If a character is writ-
     ten to a VT on which screen mapping is enabled, the character actually
     drawn on the screen is going to be the character in the array at the
     index value given by the original character.

     For example, char foo[256] is the screen map. foo[a] is set to the
     value "p". If the screen map foo is enabled on the VT, every time the
     character "a" is written to the terminal, "p" will be displayed.

     If a file name is given on the argument line, the respective mapping
     table is configured from the contents of the input file. If no file is
     given, the default files /usr/lib/keyboard/keys,
     /usr/lib/keyboard/strings and /usr/lib/console/screens are used. The
     -d option causes the mapping table to be read from the kernel instead
     of written and an ASCII version to be displayed on the standard out-
     put. The format of the output is suitable for use as input files to
     mapscrn, mapkey, or mapstr.

     The sum of the characters in the strings for mapstr (in the
     /usr/lib/keyboard/strings file) can be a maximum of 512 (including the
     end-of-string character).

     mapkey, when downloading a mapping table, overwrites the default map-
     ping table for all devices (thus affecting all devices using the
     default mapping table) unless the -V option is specified. In this
     case, only the device in which mapkey -V was invoked is affected, and
     the device will revert to using the default mapping table when it is



Page 1                       Reliant UNIX 5.44                Printed 11/98

mapkey(1M)                                                       mapkey(1M)

     closed or the user logs out.

     Normally only the system administrator can use mapkey to overwrite the
     default mapping table. The -V option allows ordinary users to do so as
     well.

     When mapkey -d displays the mapping table being used, it is the
     default mapping table unless the -V option is specified. In this case,
     mapkey displays the mapping table in use on the device in which mapkey
     -V was invoked.

     Non-superusers can run mapkey and mapstr when the -d option is given.

     With the -o or -x options, mapkey displays the mapping table in octal
     or hexadecimal, respectively.

NOTES
     There is no way to specify that the map utilities read their confi-
     guration tables from standard input.

FILES
     /usr/lib/keyboard/*

     /usr/lib/console/*

SEE ALSO
     display(7) [on RM400], keyboard(7) [on RM400], mapkey(7).



























Page 2                       Reliant UNIX 5.44                Printed 11/98