xref: /freebsd/usr.sbin/kbdmap/kbdmap.1 (revision 17d6c636720d00f77e5d098daf4c278f89d84f7b)
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 March 25, 1995
27.Dt KBDMAP 1
28.Os
29.Sh NAME
30.Nm kbdmap ,
31.Nm vidfont
32.Nd front end for syscons
33.Sh SYNOPSIS
34.Nm
35.Op Fl K
36.Op Fl V
37.Op Fl d | Fl default
38.Op Fl h | Fl help
39.Op Fl l | Fl lang Ar language
40.Op Fl p | Fl print
41.Op Fl r | Fl restore
42.Op Fl s | Fl show
43.Op Fl v | Fl verbose
44.Sh DESCRIPTION
45.Nm Kbdmap
46allows easy setting of available keymaps.
47The
48.Nm vidfont
49command allows the setting of fonts.
50Both examine a database for the keymaps and fonts.
51Descriptions are in English by default, but may also be
52in other languages.
53These programs are interactive and expect to run
54in a terminal to get required input (e.g., a keymap selection)
55from the user.
56.Pp
57It is strongly recommended to not choose
58.Tn MSDOS
59codepage keymaps
60or fonts.
61Use the
62.Tn ISO
63standard version if available!
64.Tn X11
65does not
66support
67.Tn MSDOS
68codepage.
69.Pp
70The following options are available:
71.Bl -tag -width indent
72.It Fl K
73Run as command
74.Nm .
75.It Fl V
76Run as command
77.Nm vidfont .
78.It Fl d , Fl default
79Use default language.
80Ignore
81.Ev LANG
82environment variable.
83.It Fl h , Fl help
84Print options and exit.
85.It Fl l , Fl lang Ar language
86Use
87.Ar language
88for description and menu
89.It Fl p , Fl print
90Print description  of available keymaps or fonts
91to stdout and exit.
92.It Fl r , Fl restore
93Load default font from
94.Pa /etc/rc.conf .
95.It Fl s , Fl show
96Show currently supported languages and exit.
97.It Fl v , Fl verbose
98More warnings.
99.El
100.Sh ENVIRONMENT
101.Bl -tag -width LANG -compact
102.It Ev LANG
103preferred language
104.El
105.Sh FILES
106.Bl -tag -width /usr/share/syscons/keymaps/INDEX.keymaps -compact
107.It Pa /usr/share/syscons/keymaps/INDEX.keymaps
108database for keymaps
109.It Pa /usr/share/syscons/fonts/INDEX.fonts
110database for fonts
111.It Pa /etc/rc.conf
112default font
113.It Pa /usr/X11/lib/X11/locale/locale.alias
114describe common
115.Ev LANG
116values
117.El
118.Sh BUGS
119.\" .Nm kbdmap/vidfont
120.\" does not know which font is in use. E.g. if the current font
121.\" is iso-8859-1 and you chose lang 'ru' (for Russian)
122.\" you get funny latin1 characters and not russkij shrift.
123.\"
124.Nm
125and
126.Nm vidfont
127work only on a (virtual) console and not with
128.Tn X11 .
129.Sh SEE ALSO
130.Xr dialog 1 ,
131.Xr kbdcontrol 1 ,
132.Xr vidcontrol 1 ,
133.Xr kbdmap 5 ,
134.Xr rc.conf 5
135.Sh HISTORY
136The
137.Nm
138and
139.Nm vidfont
140commands appeared in
141.Fx 2.1 .
142.Sh AUTHORS
143.An Wolfram Schneider
144.Aq wosch@FreeBSD.org ,
145Berlin.
146