1.\" Copyright (c) March 1995 Wolfram Schneider <wosch@FreeBSD.org>. Berlin. 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $FreeBSD$ 26.Dd July 3, 2002 27.Dt KBDMAP 1 28.Os 29.Sh NAME 30.Nm kbdmap , 31.Nm vidfont 32.Nd front end for syscons and vt 33.Sh SYNOPSIS 34.Nm 35.Op Fl K 36.Op Fl V 37.Op Fl d | default 38.Op Fl h | help 39.Op Fl l | lang Ar language 40.Op Fl p | print 41.Op Fl r | restore 42.Op Fl s | show 43.Op Fl v | verbose 44.Sh DESCRIPTION 45The 46.Nm 47utility allows easy setting of available keymaps. 48The 49.Nm vidfont 50command allows the setting of fonts. 51Both examine a database for the keymaps and fonts. 52Descriptions are in English by default, but may also be 53in other languages. 54These programs are interactive and expect to run 55in a terminal to get required input (e.g., a keymap selection) 56from the user. 57.Pp 58It is strongly recommended to not choose 59.Tn MSDOS 60codepage keymaps 61or fonts. 62Use the 63.Tn ISO 64standard version if available! 65.Tn X11 66does not 67support 68.Tn MSDOS 69codepage. 70.Pp 71The following options are available: 72.Bl -tag -width indent 73.It Fl K 74Run as command 75.Nm . 76.It Fl V 77Run as command 78.Nm vidfont . 79.It Fl d , default 80Use default language. 81Ignore 82.Ev LANG 83environment variable. 84.It Fl h , help 85Print options and exit. 86.It Fl l , lang Ar language 87Use 88.Ar language 89for description and menu. 90.It Fl p , print 91Print description of available keymaps or fonts 92to stdout and exit. 93.It Fl r , restore 94Load default font from 95.Pa /etc/rc.conf . 96.It Fl s , show 97Show currently supported languages and exit. 98.It Fl v , verbose 99More warnings. 100.El 101.Sh ENVIRONMENT 102.Bl -tag -width LANG -compact 103.It Ev LANG 104preferred language 105.El 106.Sh FILES 107.Bl -tag -width ".Pa /usr/share/syscons/keymaps/INDEX.keymaps" -compact 108.It Pa /usr/share/syscons/keymaps/INDEX.keymaps 109.It Pa /usr/share/vt/keymaps/INDEX.keymaps 110database for keymaps 111.It Pa /usr/share/syscons/fonts/INDEX.fonts 112.It Pa /usr/share/vt/fonts/INDEX.fonts 113database for fonts 114.It Pa /etc/rc.conf 115default font 116.It Pa /usr/local/share/locale/locale.alias 117describe common 118.Ev LANG 119values 120.El 121.Sh SEE ALSO 122.Xr dialog 1 , 123.Xr kbdcontrol 1 , 124.Xr vidcontrol 1 , 125.Xr syscons 4 , 126.Xr vt 4 , 127.Xr kbdmap 5 , 128.Xr rc.conf 5 129.Sh HISTORY 130The 131.Nm 132and 133.Nm vidfont 134commands appeared in 135.Fx 2.1 . 136.Sh AUTHORS 137.An -nosplit 138.An Wolfram Schneider Aq Mt wosch@FreeBSD.org 139wrote the original Perl version. 140The current version was rewritten in C by 141.An Jonathan Belson Aq Mt jon@witchspace.com 142for 143.Fx 5.0 . 144.Sh BUGS 145.\" .Nm kbdmap/vidfont 146.\" does not know which font is in use. E.g. if the current font 147.\" is iso-8859-1 and you chose lang 'ru' (for Russian) 148.\" you get funny latin1 characters and not russkij shrift. 149.\" 150The 151.Nm 152and 153.Nm vidfont 154utilities work only on a (virtual) console and not with 155.Tn X11 . 156