xref: /freebsd/usr.sbin/kbdmap/kbdmap.1 (revision 580dc180c7ebd84a4aee27938a5f4a62520ac5d9)
1*580dc180SAlexander Ziaee.\"-
2*580dc180SAlexander Ziaee.\" SPDX-License-Identifier: BSD-2-Clause
3*580dc180SAlexander Ziaee.\"
45a80fb27SWolfram Schneider.\" Copyright (c) March 1995 Wolfram Schneider <wosch@FreeBSD.org>. Berlin.
55a80fb27SWolfram Schneider.\" All rights reserved.
64ba10315SJordan K. Hubbard.\"
74ba10315SJordan K. Hubbard.\" Redistribution and use in source and binary forms, with or without
84ba10315SJordan K. Hubbard.\" modification, are permitted provided that the following conditions
94ba10315SJordan K. Hubbard.\" are met:
104ba10315SJordan K. Hubbard.\" 1. Redistributions of source code must retain the above copyright
114ba10315SJordan K. Hubbard.\"    notice, this list of conditions and the following disclaimer.
124ba10315SJordan K. Hubbard.\" 2. Redistributions in binary form must reproduce the above copyright
134ba10315SJordan K. Hubbard.\"    notice, this list of conditions and the following disclaimer in the
144ba10315SJordan K. Hubbard.\"    documentation and/or other materials provided with the distribution.
154ba10315SJordan K. Hubbard.\"
164ba10315SJordan K. Hubbard.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
174ba10315SJordan K. Hubbard.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
184ba10315SJordan K. Hubbard.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
194ba10315SJordan K. Hubbard.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
204ba10315SJordan K. Hubbard.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
214ba10315SJordan K. Hubbard.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
224ba10315SJordan K. Hubbard.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
234ba10315SJordan K. Hubbard.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
244ba10315SJordan K. Hubbard.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
254ba10315SJordan K. Hubbard.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
264ba10315SJordan K. Hubbard.\" SUCH DAMAGE.
27*580dc180SAlexander Ziaee.Dd July 7, 2024
284ba10315SJordan K. Hubbard.Dt KBDMAP 1
29a4c37c81SRuslan Ermilov.Os
304ba10315SJordan K. Hubbard.Sh NAME
314ba10315SJordan K. Hubbard.Nm kbdmap ,
324ba10315SJordan K. Hubbard.Nm vidfont
33*580dc180SAlexander Ziaee.Nd system video console keyboard map/font dialog utilities
344ba10315SJordan K. Hubbard.Sh SYNOPSIS
35e97407b4SRuslan Ermilov.Nm
36b4356447SWolfram Schneider.Op Fl K
37b4356447SWolfram Schneider.Op Fl V
38e36f056fSRuslan Ermilov.Op Fl d | default
39e36f056fSRuslan Ermilov.Op Fl h | help
40e36f056fSRuslan Ermilov.Op Fl l | lang Ar language
41e36f056fSRuslan Ermilov.Op Fl p | print
42e36f056fSRuslan Ermilov.Op Fl r | restore
43e36f056fSRuslan Ermilov.Op Fl s | show
44e36f056fSRuslan Ermilov.Op Fl v | verbose
454ba10315SJordan K. Hubbard.Sh DESCRIPTION
467f94b8deSPhilippe CharnierThe
477f94b8deSPhilippe Charnier.Nm
487f94b8deSPhilippe Charnierutility allows easy setting of available keymaps.
494c574b95SMike PritchardThe
504ba10315SJordan K. Hubbard.Nm vidfont
514c574b95SMike Pritchardcommand allows the setting of fonts.
524c574b95SMike PritchardBoth examine a database for the keymaps and fonts.
534c574b95SMike PritchardDescriptions are in English by default, but may also be
544c574b95SMike Pritchardin other languages.
555cffcde6SMurray StokelyThese programs are interactive and expect to run
565cffcde6SMurray Stokelyin a terminal to get required input (e.g., a keymap selection)
575cffcde6SMurray Stokelyfrom the user.
584c574b95SMike Pritchard.Pp
594c574b95SMike PritchardIt is strongly recommended to not choose
604c574b95SMike Pritchard.Tn MSDOS
614c574b95SMike Pritchardcodepage keymaps
62f2e366a1SSheldon Hearnor fonts.
63f2e366a1SSheldon HearnUse the
644c574b95SMike Pritchard.Tn ISO
654c574b95SMike Pritchardstandard version if available!
664c574b95SMike Pritchard.Tn X11
674c574b95SMike Pritcharddoes not
684c574b95SMike Pritchardsupport
694c574b95SMike Pritchard.Tn MSDOS
704c574b95SMike Pritchardcodepage.
71fea43bdfSPhilippe Charnier.Pp
72fea43bdfSPhilippe CharnierThe following options are available:
73fea43bdfSPhilippe Charnier.Bl -tag -width indent
74b4356447SWolfram Schneider.It Fl K
75b4356447SWolfram SchneiderRun as command
7689a374a1SRuslan Ermilov.Nm .
77b4356447SWolfram Schneider.It Fl V
78b4356447SWolfram SchneiderRun as command
7989a374a1SRuslan Ermilov.Nm vidfont .
80e36f056fSRuslan Ermilov.It Fl d , default
81f2e366a1SSheldon HearnUse default language.
82f2e366a1SSheldon HearnIgnore
83fea43bdfSPhilippe Charnier.Ev LANG
84fea43bdfSPhilippe Charnierenvironment variable.
85e36f056fSRuslan Ermilov.It Fl h , help
864ba10315SJordan K. HubbardPrint options and exit.
87e36f056fSRuslan Ermilov.It Fl l , lang Ar language
884ba10315SJordan K. HubbardUse
894ba10315SJordan K. Hubbard.Ar language
90e36f056fSRuslan Ermilovfor description and menu.
91e36f056fSRuslan Ermilov.It Fl p , print
92b4356447SWolfram SchneiderPrint description of available keymaps or fonts
93b4356447SWolfram Schneiderto stdout and exit.
94e36f056fSRuslan Ermilov.It Fl r , restore
954c574b95SMike PritchardLoad default font from
9608aa3c90SJordan K. Hubbard.Pa /etc/rc.conf .
97e36f056fSRuslan Ermilov.It Fl s , show
98b4356447SWolfram SchneiderShow currently supported languages and exit.
99e36f056fSRuslan Ermilov.It Fl v , verbose
1004ba10315SJordan K. HubbardMore warnings.
101fea43bdfSPhilippe Charnier.El
1024a8d0283SMike Pritchard.Sh ENVIRONMENT
1038b5c4af3SRuslan Ermilov.Bl -tag -width LANG -compact
1048b5c4af3SRuslan Ermilov.It Ev LANG
105fea43bdfSPhilippe Charnierpreferred language
106fea43bdfSPhilippe Charnier.El
1074ba10315SJordan K. Hubbard.Sh FILES
108e36f056fSRuslan Ermilov.Bl -tag -width ".Pa /usr/share/syscons/keymaps/INDEX.keymaps" -compact
1094c574b95SMike Pritchard.It Pa /usr/share/syscons/keymaps/INDEX.keymaps
110f071b64eSStefan Eßer.It Pa /usr/share/vt/keymaps/INDEX.keymaps
111fea43bdfSPhilippe Charnierdatabase for keymaps
1124c574b95SMike Pritchard.It Pa /usr/share/syscons/fonts/INDEX.fonts
113f071b64eSStefan Eßer.It Pa /usr/share/vt/fonts/INDEX.fonts
114fea43bdfSPhilippe Charnierdatabase for fonts
11508aa3c90SJordan K. Hubbard.It Pa /etc/rc.conf
116fea43bdfSPhilippe Charnierdefault font
117425dcfa4SDaniel Gerzo.It Pa /usr/local/share/locale/locale.alias
118fea43bdfSPhilippe Charnierdescribe common
119fea43bdfSPhilippe Charnier.Ev LANG
120fea43bdfSPhilippe Charniervalues
121fea43bdfSPhilippe Charnier.El
1224ba10315SJordan K. Hubbard.Sh SEE ALSO
123bfd34a4aSWolfram Schneider.Xr dialog 1 ,
1244ba10315SJordan K. Hubbard.Xr kbdcontrol 1 ,
1254ba10315SJordan K. Hubbard.Xr vidcontrol 1 ,
126f071b64eSStefan Eßer.Xr syscons 4 ,
127f071b64eSStefan Eßer.Xr vt 4 ,
128ef01ff64SDavid Malone.Xr kbdmap 5 ,
12908aa3c90SJordan K. Hubbard.Xr rc.conf 5
1304ba10315SJordan K. Hubbard.Sh HISTORY
1314c574b95SMike PritchardThe
132e97407b4SRuslan Ermilov.Nm
1334c574b95SMike Pritchardand
1344c574b95SMike Pritchard.Nm vidfont
1354c574b95SMike Pritchardcommands appeared in
13685cf659aSMike Pritchard.Fx 2.1 .
137f12a1471SPhilippe Charnier.Sh AUTHORS
138fe28e568SRuslan Ermilov.An -nosplit
13901c2b8acSBaptiste Daroussin.An Wolfram Schneider Aq Mt wosch@FreeBSD.org
140ece80b1dSMark Murraywrote the original Perl version.
141ece80b1dSMark MurrayThe current version was rewritten in C by
14201c2b8acSBaptiste Daroussin.An Jonathan Belson Aq Mt jon@witchspace.com
143ece80b1dSMark Murrayfor
144ece80b1dSMark Murray.Fx 5.0 .
14559a3c79dSRuslan Ermilov.Sh BUGS
14659a3c79dSRuslan Ermilov.\" .Nm kbdmap/vidfont
14759a3c79dSRuslan Ermilov.\" does not know which font is in use. E.g. if the current font
14859a3c79dSRuslan Ermilov.\" is iso-8859-1 and you chose lang 'ru' (for Russian)
14959a3c79dSRuslan Ermilov.\" you get funny latin1 characters and not russkij shrift.
15059a3c79dSRuslan Ermilov.\"
15159a3c79dSRuslan ErmilovThe
15259a3c79dSRuslan Ermilov.Nm
15359a3c79dSRuslan Ermilovand
15459a3c79dSRuslan Ermilov.Nm vidfont
15559a3c79dSRuslan Ermilovutilities work only on a (virtual) console and not with
15659a3c79dSRuslan Ermilov.Tn X11 .
157