source: general/sysutils/blocaled.xml@ 9066cb4

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 9066cb4 was 9066cb4, checked in by Pierre Labastie <pieere@…>, 14 months ago

Forgotten tag after update

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23571 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.7 KB
Line 
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<!ENTITY blocaled-download-http "https://github.com/pierre-labastie/blocaled/releases/download/v&blocaled-version;/blocaled-&blocaled-version;.tar.xz">
8 <!ENTITY blocaled-download-ftp " ">
9 <!ENTITY blocaled-md5sum "b05b42bf500791716214d12da34d3f7d">
10 <!ENTITY blocaled-size "257 KB">
11 <!ENTITY blocaled-buildsize "4.2 MB (with tests)">
12 <!ENTITY blocaled-time "0.1 SBU (with tests)">
13]>
14
15<sect1 id="blocaled" revision="sysv" xreflabel="blocaled-&blocaled-version;">
16 <?dbhtml filename="blocaled.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>blocaled-&blocaled-version;</title>
24
25 <indexterm zone="blocaled">
26 <primary sortas="a-blocaled">blocaled</primary>
27 </indexterm>
28
29 <!--Required section-->
30 <sect2 role="package">
31 <title>Introduction to blocaled</title>
32
33 <para>
34 <application>blocaled</application> is an implementation of the
35 <emphasis>org.freedesktop.locale1</emphasis> D&ndash;Bus protocol,
36 which normally comes with <application>systemd</application>. It is
37 needed by the <application>GNOME</application> desktop.
38 </para>
39
40 &lfs10_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&blocaled-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&blocaled-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &blocaled-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &blocaled-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &blocaled-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &blocaled-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">blocaled Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="polkit"/> and
81 <xref linkend="libdaemon"/>
82 </para>
83
84 <para condition="html" role="usernotes">
85 User Notes: <ulink url="&blfs-wiki;/blocaled"/>
86 </para>
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of blocaled</title>
91
92 <para>
93 Install <application>blocaled</application> by running the following
94 commands:
95 </para>
96
97<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
98make</userinput></screen>
99
100 <para>
101 To test the results, issue: <command>make check</command>.
102 </para>
103
104 <para>
105 Now, as the <systemitem class="username">root</systemitem> user:
106 </para>
107
108<screen role="root"><userinput>make install</userinput></screen>
109 </sect2>
110
111 <sect2 role="configuration">
112 <title>Configuring blocaled</title>
113
114 <sect3 id="blocaled-config">
115 <title>Config Files</title>
116 <para>
117 <filename>/etc/blocaled.conf</filename>
118 </para>
119
120 <indexterm zone="blocaled blocaled-config">
121 <primary
122 sortas="e-etc-blocaled.conf">/etc/blocaled.conf</primary>
123 </indexterm>
124 </sect3>
125
126 <sect3><title>Configuration Information</title>
127
128 <para>
129 <filename>/etc/blocaled.conf</filename> contains the location of
130 the settings files used by <application>blocaled</application>. The
131 defaults are suitable for BLFS. Information about the entries is
132 available as comments in the file.
133 </para>
134
135 <para>
136 The <emphasis>org.freedesktop.locale1</emphasis> protocol is
137 unable to export locale variables. Locale settings are stored
138 by default in <filename>/etc/locale.conf</filename>. We need to
139 retrieve them in the bash profile. As the <systemitem class="username">
140 root</systemitem> user, issue:
141 </para>
142
143<screen role="root"><userinput>cat &gt; /etc/profile.d/i18n.sh &lt;&lt; "EOF"
144<literal># Begin /etc/profile.d/i18n.sh
145
146if [ -r /etc/locale.conf ]; then source /etc/locale.conf; fi
147
148if [ -n "$LANG" ]; then export LANG; fi
149if [ -n "$LC_TYPE" ]; then export LC_TYPE; fi
150if [ -n "$LC_NUMERIC" ]; then export LC_NUMERIC; fi
151if [ -n "$LC_TIME" ]; then export LC_TIME; fi
152if [ -n "$LC_COLLATE" ]; then export LC_COLLATE; fi
153if [ -n "$LC_MONETARY" ]; then export LC_MONETARY; fi
154if [ -n "$LC_MESSAGES" ]; then export LC_MESSAGES; fi
155if [ -n "$LC_PAPER" ]; then export LC_PAPER; fi
156if [ -n "$LC_NAME" ]; then export LC_NAME; fi
157if [ -n "$LC_ADDRESS" ]; then export LC_ADDRESS; fi
158if [ -n "$LC_TELEPHONE" ]; then export LC_TELEPHONE; fi
159if [ -n "$LC_MEASUREMENT" ]; then export LC_MEASUREMENT; fi
160if [ -n "$LC_IDENTIFICATION" ]; then export LC_IDENTIFICATION; fi
161
162# End /etc/profile.d/i18n.sh</literal>
163EOF</userinput></screen>
164
165 <para>
166 Then the <filename>/etc/locale</filename> file should be generated,
167 as the <systemitem class="username">root</systemitem> user:
168 </para>
169
170<screen role="root"><userinput>cat &gt; /etc/locale.conf &lt;&lt; EOF
171<literal># Begin /etc/locale.conf
172
173LANG=$LANG
174
175# End /etc/locale.conf</literal>
176EOF</userinput></screen>
177
178 <para>
179 If you plan to run an X (or Wayland) Window system, you may want to
180 set up your X keyboard. The best way to do it is to retrieve the
181 settings from <filename>/etc/sysconfig/console</filename>, and feed
182 them to the <application>blocaled</application> daemon. As the
183 <systemitem class="username">root</systemitem> user:
184 </para>
185
186<screen role="root"><userinput>source /etc/sysconfig/console &amp;&amp;
187KEYMAP=${KEYMAP:-us} &amp;&amp;
188
189gdbus call --system \
190 --dest org.freedesktop.locale1 \
191 --object-path /org/freedesktop/locale1 \
192 --method org.freedesktop.locale1.SetVConsoleKeyboard \
193 "$KEYMAP" "$KEYMAP_CORRECTIONS" true true</userinput></screen>
194
195 <para>
196 This should create or modify the Xorg configuration file (default is
197 <filename>/etc/X11/xorg.conf.d/30-keyboard.conf</filename>) to match
198 the keyboard settings set in <envar>KEYMAP</envar>.
199 </para>
200
201 </sect3>
202
203 </sect2>
204
205 <sect2 role="content">
206 <title>Contents</title>
207
208 <segmentedlist>
209 <segtitle>Installed Program</segtitle>
210 <segtitle>Installed Library</segtitle>
211 <segtitle>Installed Directory</segtitle>
212
213 <seglistitem>
214 <seg>
215 blocaled (in <filename class="directory">/usr/libexec</filename>)
216 </seg>
217 <seg>
218 None
219 </seg>
220 <seg>
221 /usr/share/blocaled
222 </seg>
223 </seglistitem>
224 </segmentedlist>
225
226 <variablelist>
227 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
228 <?dbfo list-presentation="list"?>
229 <?dbhtml list-presentation="table"?>
230
231 <varlistentry id="blocaled-prog">
232 <term><command>blocaled</command></term>
233 <listitem>
234 <para>
235 is the daemon implementing the
236 <emphasis>org.freedesktop.locale1</emphasis> D&ndash;Bus protocol
237 </para>
238 <indexterm zone="blocaled blocaled-prog">
239 <primary sortas="b-blocaled">blocaled</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243 </variablelist>
244 </sect2>
245</sect1>
Note: See TracBrowser for help on using the repository browser.