source: BOOK/system-config/common/console.xml@ c832708

systemd
Last change on this file since c832708 was 0d36d0a, checked in by Chris Staub <chris@…>, 11 years ago

More updates to chapter references

  • Property mode set to 100644
File size: 4.3 KB
RevLine 
[3f8be484]1<?xml version="1.0" encoding="ISO-8859-1"?>
[aa18ac0]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[3f8be484]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
[0d36d0a]8<sect1 id="ch-config-console">
[3f8be484]9 <?dbhtml filename="console.html"?>
10 <title>Configuring the Linux Console</title>
11
[0d36d0a]12 <indexterm zone="ch-config-console">
[3f8be484]13 <primary sortas="d-console">console</primary>
14 <secondary>configuring</secondary></indexterm>
15
[40fbd36]16 <para>This section discusses how to configure the
[cdd311db]17 <command>systemd-vconsole-setup</command> system service which configures
18 the virtual console font and console keymap.
[24b004c]19
[cdd311db]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
[40fbd36]27 <filename class="directory">/usr/share/consolefonts</filename> for valid
[cdd311db]28 screen fonts.</para>
[40fbd36]29
[cdd311db]30 <para>The <filename>/etc/vconsole.conf</filename> file should contain lines
31 of the form: VARIABLE="value". The following variables are recognized:</para>
[40fbd36]32
[cdd311db]33 <variablelist>
[40fbd36]34
[cdd311db]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>
[40fbd36]42
[cdd311db]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
79FONT=Lat2-Terminus16</literal>
[40fbd36]80EOF</userinput></screen>
[3f8be484]81
[cdd311db]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
[0131d1b]88 be used only on a system booted with systemd.</para></note>
[cdd311db]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
[3f8be484]136</sect1>
Note: See TracBrowser for help on using the repository browser.