[3f8be484] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?> |
---|
[aa18ac0] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ |
---|
[3f8be484] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent"> |
---|
| 5 | %general-entities; |
---|
| 6 | ]> |
---|
| 7 | |
---|
[0d36d0a] | 8 | <sect1 id="ch-config-console"> |
---|
[3f8be484] | 9 | <?dbhtml filename="console.html"?> |
---|
| 10 | <title>Configuring the Linux Console</title> |
---|
| 11 | |
---|
[0d36d0a] | 12 | <indexterm zone="ch-config-console"> |
---|
[3f8be484] | 13 | <primary sortas="d-console">console</primary> |
---|
| 14 | <secondary>configuring</secondary></indexterm> |
---|
| 15 | |
---|
[40fbd36] | 16 | <para>This section discusses how to configure the |
---|
[cdd311db] | 17 | <command>systemd-vconsole-setup</command> system service which configures |
---|
| 18 | the virtual console font and console keymap. |
---|
[24b004c] | 19 | |
---|
[cdd311db] | 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 |
---|
[40fbd36] | 27 | <filename class="directory">/usr/share/consolefonts</filename> for valid |
---|
[cdd311db] | 28 | screen fonts.</para> |
---|
[40fbd36] | 29 | |
---|
[cdd311db] | 30 | <para>The <filename>/etc/vconsole.conf</filename> file should contain lines |
---|
| 31 | of the form: VARIABLE="value". The following variables are recognized:</para> |
---|
[40fbd36] | 32 | |
---|
[cdd311db] | 33 | <variablelist> |
---|
[40fbd36] | 34 | |
---|
[cdd311db] | 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> |
---|
[40fbd36] | 42 | |
---|
[cdd311db] | 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> |
---|
[40fbd36] | 80 | EOF</userinput></screen> |
---|
[3f8be484] | 81 | |
---|
[cdd311db] | 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 |
---|
[0131d1b] | 88 | be used only on a system booted with systemd.</para></note> |
---|
[cdd311db] | 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 |
---|
[e318995] | 133 | <ulink url="http://cblfs.clfs.org/index.php/Xorg7/Data"> |
---|
[cdd311db] | 134 | XKeyboard Client</ulink> package from CBLFS.</para></note> |
---|
| 135 | |
---|
[3f8be484] | 136 | </sect1> |
---|