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