1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
4 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
5 | %general-entities;
|
---|
6 | ]>
|
---|
7 |
|
---|
8 | <sect1 id="ch-config-console" revision="systemd">
|
---|
9 | <?dbhtml filename="console.html"?>
|
---|
10 |
|
---|
11 | <title>Configuring the Linux Console</title>
|
---|
12 |
|
---|
13 | <indexterm zone="ch-config-console">
|
---|
14 | <primary sortas="d-console">console</primary>
|
---|
15 | <secondary>configuring</secondary>
|
---|
16 | </indexterm>
|
---|
17 |
|
---|
18 | <para>This section discusses how to configure the
|
---|
19 | <command>systemd-vconsole-setup</command> system service, which configures
|
---|
20 | the virtual console font and console keymap.</para>
|
---|
21 |
|
---|
22 | <para>The <command>systemd-vconsole-setup</command> service reads the
|
---|
23 | <filename>/etc/vconsole.conf</filename> file for configuration
|
---|
24 | information. Decide which keymap and screen font will be used. Various
|
---|
25 | language-specific HOWTOs can also help with this, see <ulink
|
---|
26 | url="http://www.tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>.
|
---|
27 | Examine the output of <command>localectl list-keymaps</command> for a list of
|
---|
28 | valid console keymaps. Look in the
|
---|
29 | <filename class="directory">/usr/share/consolefonts</filename>
|
---|
30 | directory for valid screen fonts.</para>
|
---|
31 |
|
---|
32 | <para>The <filename>/etc/vconsole.conf</filename> file should contain lines
|
---|
33 | of the form: VARIABLE="value". The following variables are recognized:</para>
|
---|
34 |
|
---|
35 | <variablelist>
|
---|
36 |
|
---|
37 | <varlistentry>
|
---|
38 | <term>KEYMAP</term>
|
---|
39 | <listitem>
|
---|
40 | <para>This variable specifies the key mapping table for the keyboard. If
|
---|
41 | unset, it defaults to <literal>us</literal>.</para>
|
---|
42 | </listitem>
|
---|
43 | </varlistentry>
|
---|
44 |
|
---|
45 | <varlistentry>
|
---|
46 | <term>KEYMAP_TOGGLE</term>
|
---|
47 | <listitem>
|
---|
48 | <para>This variable can be used to configure a second toggle keymap and
|
---|
49 | is unset by default.</para>
|
---|
50 | </listitem>
|
---|
51 | </varlistentry>
|
---|
52 |
|
---|
53 | <varlistentry>
|
---|
54 | <term>FONT</term>
|
---|
55 | <listitem>
|
---|
56 | <para>This variable specifies the font used by the virtual
|
---|
57 | console.</para>
|
---|
58 | </listitem>
|
---|
59 | </varlistentry>
|
---|
60 |
|
---|
61 | <varlistentry>
|
---|
62 | <term>FONT_MAP</term>
|
---|
63 | <listitem>
|
---|
64 | <para>This variable specifies the console map to be used.</para>
|
---|
65 | </listitem>
|
---|
66 | </varlistentry>
|
---|
67 |
|
---|
68 | <varlistentry>
|
---|
69 | <term>FONT_UNIMAP</term>
|
---|
70 | <listitem>
|
---|
71 | <para>This variable specifies the Unicode font map.</para>
|
---|
72 | </listitem>
|
---|
73 | </varlistentry>
|
---|
74 |
|
---|
75 | </variablelist>
|
---|
76 |
|
---|
77 | <para>An example for a German keyboard and console is given below:</para>
|
---|
78 | <!-- This is what is used by jhalfs for creating the vconsole.conf file.
|
---|
79 | Whenever you want to change the following, please inform the jhalfs
|
---|
80 | maintainer(s). -->
|
---|
81 | <screen><userinput>cat > /etc/vconsole.conf << "EOF"
|
---|
82 | <literal>KEYMAP=de-latin1
|
---|
83 | FONT=Lat2-Terminus16</literal>
|
---|
84 | EOF</userinput></screen>
|
---|
85 |
|
---|
86 | <para>You can change KEYMAP value at runtime by using the
|
---|
87 | <command>localectl</command> utility:</para>
|
---|
88 |
|
---|
89 | <screen role="nodump"><userinput>localectl set-keymap MAP</userinput></screen>
|
---|
90 |
|
---|
91 | <note><para>Please note that the <command>localectl</command> command can
|
---|
92 | be used only on a system booted with systemd.</para></note>
|
---|
93 |
|
---|
94 | <para>You can also use <command>localectl</command> utility with the
|
---|
95 | corresponding parameters to change X11 keyboard layout, model, variant
|
---|
96 | and options:</para>
|
---|
97 |
|
---|
98 | <screen role="nodump"><userinput>localectl set-x11-keymap LAYOUT [MODEL] [VARIANT] [OPTIONS]</userinput></screen>
|
---|
99 |
|
---|
100 | <para>To list possible values for <command>localectl set-x11-keymap</command>
|
---|
101 | parameters, run <command>localectl</command> with parameters listed below:
|
---|
102 | </para>
|
---|
103 |
|
---|
104 | <variablelist>
|
---|
105 |
|
---|
106 | <varlistentry>
|
---|
107 | <term>list-x11-keymap-models</term>
|
---|
108 | <listitem>
|
---|
109 | <para>Shows known X11 keyboard mapping models.</para>
|
---|
110 | </listitem>
|
---|
111 | </varlistentry>
|
---|
112 |
|
---|
113 | <varlistentry>
|
---|
114 | <term>list-x11-keymap-layouts</term>
|
---|
115 | <listitem>
|
---|
116 | <para>Shows known X11 keyboard mapping layouts.</para>
|
---|
117 | </listitem>
|
---|
118 | </varlistentry>
|
---|
119 |
|
---|
120 | <varlistentry>
|
---|
121 | <term>list-x11-keymap-variants</term>
|
---|
122 | <listitem>
|
---|
123 | <para>Shows known X11 keyboard mapping variants.</para>
|
---|
124 | </listitem>
|
---|
125 | </varlistentry>
|
---|
126 |
|
---|
127 | <varlistentry>
|
---|
128 | <term>list-x11-keymap-options</term>
|
---|
129 | <listitem>
|
---|
130 | <para>Shows known X11 keyboard mapping options.</para>
|
---|
131 | </listitem>
|
---|
132 | </varlistentry>
|
---|
133 |
|
---|
134 | </variablelist>
|
---|
135 |
|
---|
136 | <note><para>Using any of the parameters listed above requires the
|
---|
137 | XKeyboard-Config package from BLFS.</para></note>
|
---|
138 |
|
---|
139 | </sect1>
|
---|