xref: /freebsd/usr.sbin/kbdmap/kbdmap.1 (revision 1b6c76a2fe091c74f08427e6c870851025a9cf67)
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 FreeBSD
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.
53.Pp
54It is strongly recommended to not choose
55.Tn MSDOS
56codepage keymaps
57or fonts.
58Use the
59.Tn ISO
60standard version if available!
61.Tn X11
62does not
63support
64.Tn MSDOS
65codepage.
66.Pp
67The following options are available:
68.Bl -tag -width indent
69.It Fl K
70Run as command
71.Xr kbdmap 1 .
72.It Fl V
73Run as command
74.Xr vidfont 1 .
75.It Fl d , Fl default
76Use default language.
77Ignore
78.Ev LANG
79environment variable.
80.It Fl h , Fl help
81Print options and exit.
82.It Fl l , Fl lang Ar language
83Use
84.Ar language
85for description and menu
86.It Fl p , Fl print
87Print description  of available keymaps or fonts
88to stdout and exit.
89.It Fl r , Fl restore
90Load default font from
91.Pa /etc/rc.conf .
92.It Fl s , Fl show
93Show currently supported languages and exit.
94.It Fl v , Fl verbose
95More warnings.
96.El
97.Sh ENVIRONMENT
98.Bl -tag -width LANG -compact
99.It Ev LANG
100preferred language
101.El
102.Sh FILES
103.Bl -tag -width /usr/share/syscons/keymaps/INDEX.keymaps -compact
104.It Pa /usr/share/syscons/keymaps/INDEX.keymaps
105database for keymaps
106.It Pa /usr/share/syscons/fonts/INDEX.fonts
107database for fonts
108.It Pa /etc/rc.conf
109default font
110.It Pa /usr/X11/lib/X11/locale/locale.alias
111describe common
112.Ev LANG
113values
114.El
115.Sh BUGS
116.\" .Nm kbdmap/vidfont
117.\" does not know which font is in use. E.g. if the current font
118.\" is iso-8859-1 and you chose lang 'ru' (for Russian)
119.\" you get funny latin1 characters and not russkij shrift.
120.\"
121.Nm Vidcontrol
122and
123.Nm kbdcontrol
124work only on a (virtual) console and not with
125.Tn X11 .
126.Sh SEE ALSO
127.Xr dialog 1 ,
128.Xr kbdcontrol 1 ,
129.Xr vidcontrol 1 ,
130.Xr kbdmap 5 ,
131.Xr rc.conf 5
132.Sh HISTORY
133The
134.Nm
135and
136.Nm vidfont
137commands appeared in
138.Fx 2.1 .
139.Sh AUTHORS
140.An Wolfram Schneider
141.Aq wosch@FreeBSD.org ,
142Berlin.
143