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