consoled.xml 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  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. <sect1 id="ch-config-console" revision="systemd">
  8. <?dbhtml filename="console.html"?>
  9. <title>Configuring the Linux Console</title>
  10. <indexterm zone="ch-config-console">
  11. <primary sortas="d-console">console</primary>
  12. <secondary>configuring</secondary>
  13. </indexterm>
  14. <para>This section discusses how to configure the
  15. <command>systemd-vconsole-setup</command> system service, which configures
  16. the virtual console font and console keymap.</para>
  17. <para>The <command>systemd-vconsole-setup</command> service reads the
  18. <filename>/etc/vconsole.conf</filename> file for configuration
  19. information. Decide which keymap and screen font will be used. Various
  20. language-specific HOWTOs can also help with this, see <ulink
  21. url="http://www.tldp.org/HOWTO/HOWTO-INDEX/other-lang.html"/>.
  22. Examine <command>localectl list-keymaps</command> output for a list of
  23. valid console keymaps. Look in
  24. <filename class="directory">/usr/share/consolefonts</filename>
  25. directory for valid screen fonts.</para>
  26. <para>The <filename>/etc/vconsole.conf</filename> file should contain lines
  27. of the form: VARIABLE="value". The following variables are recognized:</para>
  28. <variablelist>
  29. <varlistentry>
  30. <term>KEYMAP</term>
  31. <listitem>
  32. <para>This variable specifies the key mapping table for the keyboard. If
  33. unset, it defaults to <literal>us</literal>.</para>
  34. </listitem>
  35. </varlistentry>
  36. <varlistentry>
  37. <term>KEYMAP_TOGGLE</term>
  38. <listitem>
  39. <para>This variable can be used to configure a second toggle keymap and
  40. is unset by default.</para>
  41. </listitem>
  42. </varlistentry>
  43. <varlistentry>
  44. <term>FONT</term>
  45. <listitem>
  46. <para>This variable specifies the font used by the virtual
  47. console.</para>
  48. </listitem>
  49. </varlistentry>
  50. <varlistentry>
  51. <term>FONT_MAP</term>
  52. <listitem>
  53. <para>This variable specifies the console map to be used.</para>
  54. </listitem>
  55. </varlistentry>
  56. <varlistentry>
  57. <term>FONT_UNIMAP</term>
  58. <listitem>
  59. <para>This variable specifies the Unicode font map.</para>
  60. </listitem>
  61. </varlistentry>
  62. </variablelist>
  63. <para>An example for a German keyboard and console is given below:</para>
  64. <!-- This is what is used by jhalfs for creating the vconsole.conf file.
  65. Whenever you want to change the following, please inform the jhalfs
  66. maintainer(s). -->
  67. <screen><userinput>cat &gt; /etc/vconsole.conf &lt;&lt; "EOF"
  68. <literal>KEYMAP=de-latin1
  69. FONT=Lat2-Terminus16</literal>
  70. EOF</userinput></screen>
  71. <para>You can change KEYMAP value at runtime by using the
  72. <command>localectl</command> utility:</para>
  73. <screen role="nodump"><userinput>localectl set-keymap MAP</userinput></screen>
  74. <note><para>Please note that the <command>localectl</command> command can
  75. be used only on a system booted with systemd.</para></note>
  76. <para>You can also use <command>localectl</command> utility with the
  77. corresponding parameters to change X11 keyboard layout, model, variant
  78. and options:</para>
  79. <screen role="nodump"><userinput>localectl set-x11-keymap LAYOUT [MODEL] [VARIANT] [OPTIONS]</userinput></screen>
  80. <para>To list possible values for <command>localectl set-x11-keymap</command>
  81. parameters, run <command>localectl</command> with parameters listed below:
  82. </para>
  83. <variablelist>
  84. <varlistentry>
  85. <term>list-x11-keymap-models</term>
  86. <listitem>
  87. <para>Show known X11 keyboard mapping models.</para>
  88. </listitem>
  89. </varlistentry>
  90. <varlistentry>
  91. <term>list-x11-keymap-layouts</term>
  92. <listitem>
  93. <para>Show known X11 keyboard mapping layouts.</para>
  94. </listitem>
  95. </varlistentry>
  96. <varlistentry>
  97. <term>list-x11-keymap-variants</term>
  98. <listitem>
  99. <para>Show known X11 keyboard mapping variants.</para>
  100. </listitem>
  101. </varlistentry>
  102. <varlistentry>
  103. <term>list-x11-keymap-options</term>
  104. <listitem>
  105. <para>Show known X11 keyboard mapping options.</para>
  106. </listitem>
  107. </varlistentry>
  108. </variablelist>
  109. <note><para>Using any of the parameters listed above requires the
  110. XKeyboard Config package from BLFS.</para></note>
  111. </sect1>