Changeset cdd311db


Ignore:
Timestamp:
Jan 23, 2014, 11:47:46 AM (10 years ago)
Author:
William Harrington <kb0iic@…>
Branches:
clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit
Children:
ed3648a
Parents:
eaeb8faf
Message:

Update text and commands regarding systemd and the console.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • BOOK/bootscripts/common/console.xml

    reaeb8faf rcdd311db  
    1515
    1616  <para>This section discusses how to configure the
    17   <filename>vconsole.conf</filename> file that sets up the keyboard map and the
    18   console font. If non-ASCII characters (e.g., the British pound sign and Euro
    19   character) will not be used and the keyboard is most likely a U.S. one. The
    20   defaults in the file will probably be suitable for you.</para>
     17  <command>systemd-vconsole-setup</command> system service which configures
     18  the virtual console font and console keymap.
     19 
     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
     27  <filename class="directory">/usr/share/consolefonts</filename> for valid
     28  screen fonts.</para>
    2129
    22   <para>The <filename>vconsole.conf</filename> file is read by the init system
    23   and applied on startup. Decide which keymap and screen font will be used.
    24   Various language-specific HOWTO's can also help with this (see
    25   <ulink url="http://www.tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>. Look in
    26   <filename class="directory">/usr/share/consolefonts</filename> for valid
    27   screen fonts and <filename class="directory">/usr/share/keymaps</filename> for
    28   valid keymaps.</para>
     30  <para>The <filename>/etc/vconsole.conf</filename> file should contain lines
     31  of the form: VARIABLE="value". The following variables are recognized:</para>
    2932
    30   <para>The default <filename>/etc/vconsole.conf</filename> is set up for a us
    31   keymap. You will need to edit the file to your specific needs. The
    32   <filename>vconsole.conf</filename> man page has some information about
    33   additional configuration options you may need or want.</para>
     33  <variablelist>
    3434
    35 <screen><userinput>cat &gt; /etc/vconsole.conf &lt;&lt; "EOF"
    36 # Begin /etc/vconsole.conf
     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>
    3742
    38 KEYMAP=us
    39 FONT=drdos8x16
     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>
    4050
    41 # End /etc/vconsole.conf
     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 &gt; /etc/vconsole.conf &lt;&lt; "EOF"
     78<literal>KEYMAP=de-latin1
     79FONT=Lat2-Terminus16</literal>
    4280EOF</userinput></screen>
    4381
     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
     88  be used  only on a system booted with Systemd.</para></note>
     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
     133  <ulink url="http://cblfs.cross-lfs.org/index.php/Xorg7/Data">
     134  XKeyboard Client</ulink> package from CBLFS.</para></note>
     135
    44136</sect1>
Note: See TracChangeset for help on using the changeset viewer.