[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[b06ca36] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[673b0d8] | 4 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
[d781ffb] | 7 |
|
---|
[7d096f3] | 8 | <sect1 id="ch-scripts-console">
|
---|
[d781ffb] | 9 | <?dbhtml filename="console.html"?>
|
---|
| 10 |
|
---|
| 11 | <title>Configuring the Linux Console</title>
|
---|
| 12 |
|
---|
| 13 | <indexterm zone="ch-scripts-console">
|
---|
| 14 | <primary sortas="d-console">console</primary>
|
---|
| 15 | <secondary>configuring</secondary>
|
---|
| 16 | </indexterm>
|
---|
| 17 |
|
---|
[b06a0085] | 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
|
---|
[6b13ebc6] | 24 | information. Decide which keymap and screen font will be used. Various
|
---|
| 25 | language-specific HOWTOs can also help with this, see <ulink
|
---|
[fa21b3d] | 26 | url="http://www.tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>. If still in
|
---|
[a3af16f] | 27 | doubt, look in the <filename class="directory">/usr/share/keymaps</filename>
|
---|
| 28 | and <filename class="directory">/usr/share/consolefonts</filename> directories
|
---|
[6b13ebc6] | 29 | for valid keymaps and screen fonts. Read <filename>loadkeys(1)</filename> and
|
---|
| 30 | <filename>setfont(8)</filename> manual pages to determine the correct
|
---|
| 31 | arguments for these programs.</para>
|
---|
[fa21b3d] | 32 |
|
---|
[b06a0085] | 33 | <para>The <filename>/etc/vconsole.conf</filename> file should contain lines
|
---|
[fa21b3d] | 34 | of the form: VARIABLE="value". The following variables are recognized:</para>
|
---|
| 35 |
|
---|
| 36 | <variablelist>
|
---|
| 37 |
|
---|
| 38 | <varlistentry>
|
---|
| 39 | <term>KEYMAP</term>
|
---|
| 40 | <listitem>
|
---|
[b06a0085] | 41 | <para>This variable specifies the key mapping table for the keyboard. If
|
---|
| 42 | unset, it defaults to <literal>us</literal>.</para>
|
---|
[fa21b3d] | 43 | </listitem>
|
---|
| 44 | </varlistentry>
|
---|
| 45 |
|
---|
| 46 | <varlistentry>
|
---|
[b06a0085] | 47 | <term>KEYMAP_TOGGLE</term>
|
---|
[fa21b3d] | 48 | <listitem>
|
---|
[b06a0085] | 49 | <para>This variable can be used to configure a second toggle keymap and
|
---|
| 50 | is unset by default.</para>
|
---|
[fa21b3d] | 51 | </listitem>
|
---|
| 52 | </varlistentry>
|
---|
| 53 |
|
---|
| 54 | <varlistentry>
|
---|
| 55 | <term>FONT</term>
|
---|
| 56 | <listitem>
|
---|
[b06a0085] | 57 | <para>This variable specifies the font used by the virtual
|
---|
| 58 | console.</para>
|
---|
[fa21b3d] | 59 | </listitem>
|
---|
| 60 | </varlistentry>
|
---|
| 61 |
|
---|
| 62 | <varlistentry>
|
---|
[b06a0085] | 63 | <term>FONT_MAP</term>
|
---|
[fa21b3d] | 64 | <listitem>
|
---|
[b06a0085] | 65 | <para>This variable specifies the console map to be used.</para>
|
---|
[fa21b3d] | 66 | </listitem>
|
---|
| 67 | </varlistentry>
|
---|
| 68 |
|
---|
| 69 | <varlistentry>
|
---|
[b06a0085] | 70 | <term>FONT_UNIMAP</term>
|
---|
[fa21b3d] | 71 | <listitem>
|
---|
[b06a0085] | 72 | <para>This variable specifies the unicode font map.</para>
|
---|
[fa21b3d] | 73 | </listitem>
|
---|
| 74 | </varlistentry>
|
---|
| 75 |
|
---|
| 76 | </variablelist>
|
---|
| 77 |
|
---|
[b06a0085] | 78 | <para>An example for a German keyboard and console is given below:</para>
|
---|
[b32e803] | 79 |
|
---|
[b06a0085] | 80 | <screen role="nodump"><userinput>cat > /etc/vconsole.conf << "EOF"
|
---|
| 81 | <literal>KEYMAP=de-latin1
|
---|
| 82 | FONT=latarcyrheb-sun16</literal>
|
---|
[f67f5cf] | 83 | EOF</userinput></screen>
|
---|
[fa21b3d] | 84 |
|
---|
| 85 | <!-- Added because folks keep posting their console file with X questions
|
---|
| 86 | to blfs-support list -->
|
---|
| 87 | <note>
|
---|
[b06a0085] | 88 | <para>The <filename>/etc/vconsole.conf</filename> file only controls
|
---|
| 89 | localization of the Linux text console. It has nothing to do with setting
|
---|
| 90 | the proper keyboard layout and terminal fonts in the X Window System, with
|
---|
| 91 | ssh sessions, or with a serial console.</para>
|
---|
[fa21b3d] | 92 | </note>
|
---|
[81fd230] | 93 |
|
---|
[1050066] | 94 | </sect1>
|
---|