source: lxde/apps/lxdm.xml@ b43538a

10.0 10.1 11.0 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b43538a was b43538a, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

LXDM-0.5.0 fixes: Now, hopefully, it is the definive localization fix.

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

  • Property mode set to 100644
File size: 10.0 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 <!-- Place this in the general.ent file
8 <!ENTITY TEMPLATE-version "">
9 -->
10
11 <!ENTITY lxdm-download-http "http://downloads.sourceforge.net/lxdm/lxdm-&lxdm-version;.tar.xz">
12 <!ENTITY lxdm-download-ftp " ">
13 <!ENTITY lxdm-md5sum "a51686720e606ca456d7f56ae4159d1f">
14 <!ENTITY lxdm-size "232 KB">
15 <!ENTITY lxdm-buildsize "4.7 MB">
16 <!ENTITY lxdm-time "less than 0.1 SBU ">
17]>
18
19<sect1 id="lxdm" xreflabel="LXDM-&lxdm-version;">
20 <?dbhtml filename="lxdm.html"?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>LXDM-&lxdm-version;</title>
28
29 <indexterm zone="lxdm">
30 <primary sortas="a-LXDM">LXDM</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to LXDM</title>
35
36 <para>
37 The <application>LXDM</application> is a lightweight Display Manager for
38 the <application>LXDE</application> desktop. It can also be used as an
39 alternative to other Display Managers such as
40 <application>GNOME's</application> <application>GDM</application> or
41 <application>KDE's</application> <application>KDM</application>.
42 </para>
43
44 &lfs75_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&lxdm-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&lxdm-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &lxdm-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &lxdm-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &lxdm-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &lxdm-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">LXDM Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="gtk2"/>,
85 <xref linkend="iso-codes"/> and
86 <xref linkend="librsvg"/> (runtime, for default theme background)
87 </para>
88
89 <bridgehead renderas="sect4">Recommended</bridgehead>
90 <para role="recommended">
91 <xref linkend="consolekit"/> and
92 <xref linkend="linux-pam"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional">
97 <xref linkend="gtk3"/>
98 </para>
99
100 <para condition="html" role="usernotes">
101 User Notes: <ulink url="&blfs-wiki;/lxdm"/>
102 </para>
103 </sect2>
104
105 <sect2 role="installation">
106 <title>Installation of LXDM</title>
107
108 <para>
109 First, fix some files.
110 </para>
111
112<screen><userinput>cat &gt; pam/lxdm &lt;&lt; "EOF" &amp;&amp;
113<literal>#%PAM-1.0
114auth required pam_unix.so
115auth requisite pam_nologin.so
116account required pam_unix.so
117password required pam_unix.so
118session required pam_unix.so</literal>
119EOF
120
121sed -i 's:sysconfig/i18n:profile.d/i18n.sh:g' data/lxdm.in &amp;&amp;
122sed -i 's/^bg/#&amp;/' data/lxdm.conf.in</userinput></screen>
123
124 <para>
125 Install <application>LXDM</application> by running the following
126 commands:
127 </para>
128
129<screen><userinput>./configure --prefix=/usr \
130 --sysconfdir=/etc \
131 --with-pam \
132 --with-systemdsystemunitdir=no &amp;&amp;
133make</userinput></screen>
134
135 <para>
136 This package does not come with a test suite.
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>make install</userinput></screen>
144
145 </sect2>
146
147 <!--Optional section-->
148 <sect2 role="commands">
149 <title>Command Explanations</title>
150
151 <para>
152 <command>cat &gt; pam/lxdm &lt;&lt; "EOF" ...</command>: Replace default
153 <filename>/etc/pam.d/lxdm</filename> by another one appropriate for BLFS.
154 </para>
155
156 <para>
157 <command>sed -i ... lxdm.conf.in</command>: Fix the background to the
158 default one.
159 </para>
160
161 <para>
162 <command>sed -i data/lxdm.in</command>: Fix greeter's locale for BLFS
163 specification.
164 </para>
165
166 <para>
167 <option>--with-pam</option>: This option enables use of pam
168 authentication.
169 </para>
170
171 <para>
172 <option>--with-systemdsystemunitdir=no</option>: BLFS does not support
173 systemd.
174 </para>
175
176 </sect2>
177
178 <sect2 role="configuration">
179 <title>Configuring LXDM</title>
180
181 <sect3 id="lxdm-config">
182 <title>Config Files</title>
183
184 <para>
185 <filename>/etc/lxdm/lxdm.conf</filename>
186 </para>
187
188 <indexterm zone="lxdm lxdm-config">
189 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
190 </indexterm>
191
192 </sect3>
193
194 <sect3>
195 <title>Configuration Information</title>
196
197 <para>
198 The LXDM daemon configuration <filename>/etc/lxdm/lxdm.conf</filename>
199 file options includes numlock on/off, backgraound image (bg), session,
200 etc. You can set a default session by uncommenting the line:
201 session=/usr/bin/startlxde and replacing <command>startlxde</command>
202 with your session of choice. For <application>GNOME</application>
203 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
204 session=/usr/bin/openbox-session and for
205 <application>XFCE</application> session=/usr/bin/startxfce4.
206 </para>
207
208 <para>
209 It is also possible to set the preferred session on a per-user basis by
210 editing the ~/.dmrc file for each user and adding:
211 <screen><literal>[Desktop]
212 Session=xfce</literal></screen>
213 </para>
214
215 <para>
216 You can replace the default dummy face in the greeting screen by other
217 image representing your user. For that, copy or symlink the desired
218 image to your home directory, with the name <filename>.face</filename>.
219 </para>
220
221 </sect3>
222
223 <sect3>
224 <title>Starting lxdm</title>
225
226 <para>
227 You can manually start <command>lxdm</command>, e.g, if the bootscript
228 has been installed, by running, as <systemitem
229 class="username">root</systemitem> user:
230 </para>
231
232<screen role="root"><userinput>/etc/rc.d/init.d/lxdm start</userinput></screen>
233
234 <para>
235 By definition, X should be executed at runlevel 5, consequently, the
236 same is true for <application>lxdm</application>. However, BLFS default
237 runlevel is 3. Changing to runlevel 5, from the terminal, as
238 <systemitem class="username">root</systemitem> user, makes the
239 <command>lxdm</command> bootscript to be executed, obtaining the
240 greeter screen:
241 </para>
242
243<screen role="root"><userinput>init 5</userinput></screen>
244
245 <para>
246 In order to permanently set the default to 5, obtaining the
247 <command>lxdm</command> greeter screen automatically, you can modify
248 <filename>/etc/inittab</filename>, as <systemitem
249 class="username">root</systemitem> user (the instructions below also
250 make a backup, so you can easily revert the modification):
251 </para>
252
253<screen role="root"><userinput>mv -vi /etc/inittab{,-orig} &amp;&amp;
254sed -i '/initdefault/ s/3/5/' /etc/inittab</userinput></screen>
255
256 </sect3>
257
258 <sect3 id="lxdm-init">
259 <title>Boot Script</title>
260
261 <para>
262 Install the <filename>/etc/rc.d/init.d/lxdm</filename> init script from
263 the <xref linkend="bootscripts"/> package.
264 </para>
265
266 <indexterm zone="lxdm lxdm-init">
267 <primary sortas="f-lxdm">lxdm</primary>
268 </indexterm>
269
270<screen role="root"><userinput>make install-lxdm</userinput></screen>
271
272 </sect3>
273
274 </sect2>
275 <!--Required section-->
276 <sect2 role="content">
277 <title>Contents</title>
278
279 <segmentedlist>
280 <segtitle>Installed Programs</segtitle>
281 <segtitle>Installed Libraries</segtitle>
282 <segtitle>Installed Directories</segtitle>
283
284 <seglistitem>
285 <seg>
286 lxdm, lxdm-binary and lxdm-config
287 </seg>
288 <seg>
289 None
290 </seg>
291 <seg>
292 /etc/lxdm and
293 /usr/share/lxdm
294 </seg>
295 </seglistitem>
296 </segmentedlist>
297
298 <variablelist>
299 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
300 <?dbfo list-presentation="list"?>
301 <?dbhtml list-presentation="table"?>
302
303 <!-- If the program or library name conflicts (is the same) as the
304 package name, add -prog or -lib to the varlistentry entity id
305 and the 2nd entry of the indexterm zone entity -->
306
307 <varlistentry id="lxdm-prog">
308 <term><command>lxdm</command></term>
309 <listitem>
310 <para>
311 is a script to execute <command>lxdm-binary</command>
312 </para>
313 <indexterm zone="lxdm lxdm-prog">
314 <primary sortas="b-lxdm">lxdm</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="lxdm-bin">
320 <term><command>lxdm-binary</command></term>
321 <listitem>
322 <para>
323 is the actual Display Manager; needs to be executed with option
324 <option>-d</option> to daemonize
325 </para>
326 <indexterm zone="lxdm lxdm-bin">
327 <primary sortas="b-lxdm">lxdm</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="lxdm-config-prog">
333 <term><command>lxdm-config</command></term>
334 <listitem>
335 <para>
336 is a graphical customizing program
337 </para>
338 <indexterm zone="lxdm lxdm-config">
339 <primary sortas="b-lxdm">lxdm</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343 </variablelist>
344 </sect2>
345</sect1>
Note: See TracBrowser for help on using the repository browser.