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-scripts-console" revision="systemd">
   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
  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
  79 <screen role="nodump"><userinput>cat &gt; /etc/vconsole.conf &lt;&lt; "EOF"
  80 <literal>KEYMAP=de-latin1
  81 FONT=Lat2-Terminus16</literal>
  82 EOF</userinput></screen>
  83
  84   <para>You can change KEYMAP value at runtime by using the
  85   <command>localectl</command> utility:</para>
  86
  87 <screen role="nodump"><userinput>localectl set-keymap MAP</userinput></screen>
  88
  89   <note><para>Please note that the <command>localectl</command> command can
  90   be used only on a system booted with systemd.</para></note>
  91
  92   <para>You can also use <command>localectl</command> utility with the
  93   corresponding parameters to change X11 keyboard layout, model, variant
  94   and options:</para>
  95
  96 <screen role="nodump"><userinput>localectl set-x11-keymap LAYOUT [MODEL] [VARIANT] [OPTIONS]</userinput></screen>
  97
  98   <para>To list possible values for <command>localectl set-x11-keymap</command>
  99   parameters, run <command>localectl</command> with parameters listed below:
 100   </para>
 101
 102   <variablelist>
 103
 104     <varlistentry>
 105       <term>list-x11-keymap-models</term>
 106       <listitem>
 107         <para>Show known X11 keyboard mapping models.</para>
 108       </listitem>
 109     </varlistentry>
 110
 111     <varlistentry>
 112       <term>list-x11-keymap-layouts</term>
 113       <listitem>
 114         <para>Show known X11 keyboard mapping layouts.</para>
 115       </listitem>
 116     </varlistentry>
 117
 118     <varlistentry>
 119       <term>list-x11-keymap-variants</term>
 120       <listitem>
 121         <para>Show known X11 keyboard mapping variants.</para>
 122       </listitem>
 123     </varlistentry>
 124
 125     <varlistentry>
 126       <term>list-x11-keymap-options</term>
 127       <listitem>
 128         <para>Show known X11 keyboard mapping options.</para>
 129       </listitem>
 130     </varlistentry>
 131
 132   </variablelist>
 133
 134   <note><para>Using any of the parameters listed above requires the
 135   XKeyboard Config package from BLFS.</para></note>
 136
 137 </sect1>