source: x/dm/lxdm.xml@ 7991b1f

elogind
Last change on this file since 7991b1f was 7991b1f, checked in by DJ Lucas <dj@…>, 2 years ago

Merge to HEAD 21666.
Add lxpolkit and remove LXDE dependencies on consolekit.

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

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