MAPSCRN(8) System Manager's Manual MAPSCRN(8)

# [NAME](#NAME)

mapscrn - load screen output mapping table

# [SYNOPSIS](#SYNOPSIS)

**mapscrn** \[*options*] *mapfile*

# [DESCRIPTION](#DESCRIPTION)

The **mapscrn** command is obsolete - its function is now built-in into setfont. However, for backwards compatibility it is still available as a separate command.

The *mapscrn* command loads a user defined output character mapping table into the console driver. The console driver may be later put into **use user-defined mapping table** mode by outputting a special escape sequence to the console device. This sequence is *<esc>(K* for the **G0** character set and *<esc>)K* for the **G1** character set. When the *-o* option is given, the old map is saved in *map.orig.*

# [USE](#USE)

There are two kinds of mapping tables: direct-to-font tables, that give a font position for each user byte value, and user-to-unicode tables that give a unicode value for each user byte. The corresponding glyph is now found using the unicode index of the font. The command

mapscrn trivial

sets up a one-to-one direct-to-font table where user bytes directly address the font. This is useful for fonts that are in the same order as the character set one uses. A command like

mapscrn 8859-2

sets up a user-to-unicode table that assumes that the user uses ISO 8859-2.

# [INPUT FORMAT](#INPUT_FORMAT)

The *mapscrn* command can read the map in either of two formats:  
1\. 256 or 512 bytes binary data  
2\. two-column text file  
[Format (1)](/man/os/kbd/Format.1) is a direct image of the translation *table. The 256-bytes tables are direct-to-font,* the 512-bytes tables are user-to-unicode tables. [Format (2)](/man/os/kbd/Format.2) is used to fill the *table* as follows: cell with offset mentioned in the first column is filled with the value mentioned in the second column. When values larger than 255 occur, or values are written using the U+xxxx notation, the table is assumed to be a user-to-unicode table, otherwise it is a direct-to-font table.

Values in the file may be specified in one of several **formats:**  
**1. Decimal:** String of decimal digits not starting with '0'  
**2. Octal:** String of octal digits beginning with '0'.  
**3. Hexadecimal:** String of hexadecimal digits preceded by "0x".  
**4. Unicode:** String of four hexadecimal digits preceded by "U+".  
**5. Character:** Single character enclosed in single quotes. (And the binary value is used.) Note that blank, comma, tab character and '#' cannot be specified with this format.  
**6. UTF-8 Character:** Single (possibly multi-byte) UTF-8 character, enclosed in single quotes.

Note that control characters (with codes < 32) cannot be re-mapped with *mapscrn* because they have special meaning for the driver.

# [OPTIONS](#OPTIONS)

[**-o**, **--output**=*FILE*](#o)

save the old map to the *FILE*.

[**-C**, **--console**=*DEV*](#C)

the console device to be used.

[**-v**, **--verbose**](#v)

be more verbose.

[**-V**, **--version**](#V)

print version number.

[**-h**, **--help**](#h)

print this usage message.

# [FILES](#FILES)

*/usr/share/consoletrans*

The default directory for screen mappings.

# [SEE ALSO](#SEE_ALSO)

[*setfont*(8)](/man/os/kbd/setfont.8)

# [AUTHOR](#AUTHOR)

Copyright (C) 1993 Eugene G. Crosser  
<crosser@pccross.msk.su>  
This software and documentation may be distributed freely.

24 October 2024 kbd

---

Document: mapscrn(8) from kbd 2.10.0-r4 (Chainguard OS)
Source: https://github.com/legionus/kbd