Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

  • BOOK/bootscripts/common/console.xml

    rcdd311db r9c06d27e  
    1414  <secondary>configuring</secondary></indexterm>
    1515
    16   <para>This section discusses how to configure the
    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>
     16  <para>This section discusses how to configure the <command>i18n</command>
     17  bootscript that sets up the keyboard map and the console font. If non-ASCII
     18  characters (e.g., the British pound sign and Euro character) will not be
     19  used and the keyboard is a U.S. one, skip this section. Without the
     20  configuration file, the <command>console</command> bootscript will do
     21  nothing.</para>
    2922
    30   <para>The <filename>/etc/vconsole.conf</filename> file should contain lines
    31   of the form: VARIABLE="value". The following variables are recognized:</para>
     23  <para>The <command>i18n</command> script reads the
     24  <filename>/etc/sysconfig/i18n</filename> file for configuration
     25  information. Decide which keymap and screen font will be used. Various
     26  language-specific HOWTO's can also help with this (see <ulink
     27  url="http://www.tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>. A pre-made
     28  <filename>/etc/sysconfig/i18n</filename> file with known settings for
     29  several countries was installed with the CLFS-Bootscripts package, so the
     30  relevant section can be uncommented if the country is supported. If still
     31  in doubt, look in the <filename class="directory">/usr/share/consolefonts</filename>
     32  for valid screen fonts and <filename class="directory">/usr/share/keymaps</filename>
     33  for valid keymaps.</para>
    3234
    33   <variablelist>
    34 
    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>
    42 
    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 &gt; /etc/vconsole.conf &lt;&lt; "EOF"
    78 <literal>KEYMAP=de-latin1
    79 FONT=Lat2-Terminus16</literal>
    80 EOF</userinput></screen>
    81 
    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>
     35  <para>The default <filename>/etc/sysconfig/i18n</filename> is set up for UTF-8
     36  using the us keymap. You will need to edit the file to your specific needs.
     37  The <filename>/etc/sysconfig/i18n</filename> file has additional information
     38  in it to help you to assist in configuring.</para>
    13539
    13640</sect1>
Note: See TracChangeset for help on using the changeset viewer.