[1118b17] | 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 |
|
---|
[afcfd74] | 8 | <sect1 id="ch-config-console" revision="systemd">
|
---|
[1118b17] | 9 | <?dbhtml filename="console.html"?>
|
---|
| 10 |
|
---|
| 11 | <title>Configuring the Linux Console</title>
|
---|
| 12 |
|
---|
[afcfd74] | 13 | <indexterm zone="ch-config-console">
|
---|
[1118b17] | 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
|
---|
[fb66c4c] | 26 | url="https://tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>.
|
---|
[9e7475a] | 27 | Examine the output of <command>localectl list-keymaps</command> for a list of
|
---|
[c34b4fb] | 28 | valid console keymaps. Look in the
|
---|
[1118b17] | 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>
|
---|
[8154126] | 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
|
---|
[93058448] | 80 | maintainer(s). -->
|
---|
[8154126] | 81 | <screen><userinput>cat > /etc/vconsole.conf << "EOF"
|
---|
[1118b17] | 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 |
|
---|
[4f560248] | 91 | <note><para>Please note that the <command>localectl</command> command
|
---|
| 92 | doesn't work in the chroot environment. It can only
|
---|
| 93 | be used after the LFS system is booted with systemd.</para></note>
|
---|
[1118b17] | 94 |
|
---|
| 95 | <para>You can also use <command>localectl</command> utility with the
|
---|
| 96 | corresponding parameters to change X11 keyboard layout, model, variant
|
---|
| 97 | and options:</para>
|
---|
| 98 |
|
---|
| 99 | <screen role="nodump"><userinput>localectl set-x11-keymap LAYOUT [MODEL] [VARIANT] [OPTIONS]</userinput></screen>
|
---|
| 100 |
|
---|
| 101 | <para>To list possible values for <command>localectl set-x11-keymap</command>
|
---|
| 102 | parameters, run <command>localectl</command> with parameters listed below:
|
---|
| 103 | </para>
|
---|
| 104 |
|
---|
| 105 | <variablelist>
|
---|
| 106 |
|
---|
| 107 | <varlistentry>
|
---|
| 108 | <term>list-x11-keymap-models</term>
|
---|
| 109 | <listitem>
|
---|
[9e7475a] | 110 | <para>Shows known X11 keyboard mapping models.</para>
|
---|
[1118b17] | 111 | </listitem>
|
---|
| 112 | </varlistentry>
|
---|
| 113 |
|
---|
| 114 | <varlistentry>
|
---|
| 115 | <term>list-x11-keymap-layouts</term>
|
---|
| 116 | <listitem>
|
---|
[9e7475a] | 117 | <para>Shows known X11 keyboard mapping layouts.</para>
|
---|
[1118b17] | 118 | </listitem>
|
---|
| 119 | </varlistentry>
|
---|
| 120 |
|
---|
| 121 | <varlistentry>
|
---|
| 122 | <term>list-x11-keymap-variants</term>
|
---|
| 123 | <listitem>
|
---|
[9e7475a] | 124 | <para>Shows known X11 keyboard mapping variants.</para>
|
---|
[1118b17] | 125 | </listitem>
|
---|
| 126 | </varlistentry>
|
---|
| 127 |
|
---|
| 128 | <varlistentry>
|
---|
| 129 | <term>list-x11-keymap-options</term>
|
---|
| 130 | <listitem>
|
---|
[9e7475a] | 131 | <para>Shows known X11 keyboard mapping options.</para>
|
---|
[1118b17] | 132 | </listitem>
|
---|
| 133 | </varlistentry>
|
---|
| 134 |
|
---|
| 135 | </variablelist>
|
---|
| 136 |
|
---|
[0d84af1] | 137 | <note><para>Using any of the parameters listed above requires the
|
---|
[9e7475a] | 138 | XKeyboard-Config package from BLFS.</para></note>
|
---|
[1118b17] | 139 |
|
---|
| 140 | </sect1>
|
---|