chapter07/consoled.xml

   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 <command>localectl list-keymaps</command> output for a list of
  28   valid console keymaps. Look in
  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 &gt; /etc/vconsole.conf &lt;&lt; "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>Show known X11 keyboard mapping models.</para>
 110       </listitem>
 111     </varlistentry>
 112
 113     <varlistentry>
 114       <term>list-x11-keymap-layouts</term>
 115       <listitem>
 116         <para>Show known X11 keyboard mapping layouts.</para>
 117       </listitem>
 118     </varlistentry>
 119
 120     <varlistentry>
 121       <term>list-x11-keymap-variants</term>
 122       <listitem>
 123         <para>Show known X11 keyboard mapping variants.</para>
 124       </listitem>
 125     </varlistentry>
 126
 127     <varlistentry>
 128       <term>list-x11-keymap-options</term>
 129       <listitem>
 130         <para>Show 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>