source: x/dm/lxdm.xml@ 3fa8b835

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

Merge to HEAD 21219.

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

  • Property mode set to 100644
File size: 11.4 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 <phrase revision="sysv"><xref linkend="consolekit"/> and</phrase>
89 <xref linkend="linux-pam"/>
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 include system-auth
115
116account include system-account
117
118password include system-password
119
120session required pam_limits.so
121session include system-session
122
123# End /etc/pam.d/lxdm</literal>
124EOF
125
126sed -i 's:sysconfig/i18n:profile.d/i18n.sh:g' data/lxdm.in &amp;&amp;
127sed -i 's:/etc/xprofile:/etc/profile:g' data/Xsession &amp;&amp;
128sed -e 's/^bg/#&amp;/' \
129 -e '/reset=1/ s/# //' \
130 -e 's/logou$/logout/' \
131 -e "/arg=/a arg=$XORG_PREFIX/bin/X" \
132 -i data/lxdm.conf.in</userinput></screen>
133
134 <para>
135 Install <application>LXDM</application> by running the following
136 commands:
137 </para>
138
139<screen revision="sysv"><userinput>./configure --prefix=/usr \
140 --sysconfdir=/etc \
141 --with-pam \
142 --with-systemdsystemunitdir=no &amp;&amp;
143make</userinput></screen>
144
145<screen revision="systemd"><userinput>./configure --prefix=/usr \
146 --sysconfdir=/etc \
147 --with-pam \
148 --with-systemdsystemunitdir=/lib/systemd/system &amp;&amp;
149make</userinput></screen>
150
151 <para>
152 This package does not come with a test suite.
153 </para>
154
155 <para>
156 Now, as the <systemitem class="username">root</systemitem> user:
157 </para>
158
159<screen role="root"><userinput>make install</userinput></screen>
160
161 </sect2>
162
163 <!--Optional section-->
164 <sect2 role="commands">
165 <title>Command Explanations</title>
166
167 <para>
168 <command>cat &gt; pam/lxdm &lt;&lt; "EOF" ...</command>: Replace default
169 <filename>/etc/pam.d/lxdm</filename> by another one appropriate for BLFS.
170 </para>
171
172 <para>
173 <command>sed -i ... data/lxdm.conf.in</command>: Modifications in the
174 default configuration:
175 (1) fix the background to the default one;
176 (2) restart X when session is close;
177 (3) typo; and
178 (4) include <envar>XORG_PREFIX</envar>, which may be different from
179 <filename class="directory">/usr</filename>.
180 </para>
181
182 <para>
183 <command>sed -i ... data/Xsession</command>: Source
184 <filename>/etc/profile</filename>, instead of other file, according to
185 BLFS standard.
186 </para>
187
188 <para>
189 <command>sed -i ... data/lxdm.in</command>: Fix greeter's locale for BLFS
190 specification.
191 </para>
192
193 <para>
194 <parameter>--with-pam</parameter>: This parameter enables use of pam
195 authentication.
196 </para>
197
198 <para revision="sysv">
199 <parameter>--with-systemdsystemunitdir=no</parameter>: BLFS does not
200 support systemd.
201 </para>
202
203 </sect2>
204
205 <sect2 role="configuration">
206 <title>Configuring LXDM</title>
207
208 <sect3 id="lxdm-config">
209 <title>Config Files</title>
210
211 <para>
212 <filename>/etc/lxdm/lxdm.conf</filename>
213 </para>
214
215 <indexterm zone="lxdm lxdm-config">
216 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
217 </indexterm>
218
219 </sect3>
220
221 <sect3 id="lxdm-init">
222 <title>Boot Script</title>
223
224 <para revision="sysv">
225 Install the <filename>/etc/rc.d/init.d/lxdm</filename> init script from
226 the <xref linkend="bootscripts"/> package.
227 </para>
228
229 <para revision="systemd">
230 To start <application>LXDM</application> at boot execute the following
231 command as the <systemitem class="username">root</systemitem> user:
232 </para>
233
234 <indexterm zone="lxdm lxdm-init">
235 <primary sortas="f-lxdm">lxdm</primary>
236 </indexterm>
237
238<screen role="root" revision="sysv"><userinput>make install-lxdm</userinput></screen>
239<screen role="root" revision="systemd"><userinput>systemctl enable lxdm</userinput></screen>
240
241 </sect3>
242
243 <sect3>
244 <title>Configuration Information</title>
245
246 <para>
247 The LXDM daemon configuration file
248 (<filename>/etc/lxdm/lxdm.conf</filename>) specifies options that
249 include numlock on/off, background image (bg), session, etc. You can
250 set a default session by uncommenting the line:
251 session=/usr/bin/startlxde and replacing <command>startlxde</command>
252 with your session of choice. For <application>GNOME</application>
253 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
254 session=/usr/bin/openbox-session and for
255 <application>XFCE</application> session=/usr/bin/startxfce4.
256 </para>
257
258 <para>
259 It is also possible to set the preferred session on a per-user basis by
260 editing the ~/.dmrc file for each user and adding:
261 <screen><literal>[Desktop]
262 Session=xfce</literal></screen>
263 </para>
264
265 <para>
266 You can replace the default dummy face in the greeting screen by another
267 image representing your user. For that, copy or symlink the desired
268 image to your home directory with the name <filename>.face</filename>.
269 </para>
270
271 </sect3>
272
273 <sect3 revision="sysv">
274 <title>Starting lxdm</title>
275
276 <para>
277 You can manually start <command>lxdm</command>, e.g, if the bootscript
278 has been installed, by running, as <systemitem
279 class="username">root</systemitem> user:
280 </para>
281
282<screen role="root"><userinput>/etc/rc.d/init.d/lxdm start</userinput></screen>
283
284 <para>
285 By convention, X should be executed at runlevel 5, consequently, the
286 same is true for <application>lxdm</application>. However, the LFS default
287 runlevel is 3. Changing to runlevel 5, from the console (as
288 <systemitem class="username">root</systemitem> user) starts the
289 <command>lxdm</command> bootscript and presents the
290 greeter screen:
291 </para>
292
293<screen role="root"><userinput>init 5</userinput></screen>
294
295 <para>
296 In order to permanently set the default to 5, starting the
297 <command>lxdm</command> greeter screen automatically, you can modify
298 <filename>/etc/inittab</filename>. As the <systemitem
299 class="username">root</systemitem> user:
300 </para>
301
302<screen role="root"><userinput>cp -v /etc/inittab{,-orig} &amp;&amp;
303sed -i '/initdefault/ s/3/5/' /etc/inittab</userinput></screen>
304
305 <note>
306 <para>
307 One important script, executed after login is
308 <filename>/etc/lxdm/Xsession</filename> which we have fixed to fit
309 BLFS specifications.
310 </para>
311 </note>
312
313 </sect3>
314
315 </sect2>
316 <!--Required section-->
317 <sect2 role="content">
318 <title>Contents</title>
319
320 <segmentedlist>
321 <segtitle>Installed Programs</segtitle>
322 <segtitle>Installed Libraries</segtitle>
323 <segtitle>Installed Directories</segtitle>
324
325 <seglistitem>
326 <seg>
327 lxdm, lxdm-binary and lxdm-config
328 </seg>
329 <seg>
330 None
331 </seg>
332 <seg>
333 /etc/lxdm and
334 /usr/share/lxdm
335 </seg>
336 </seglistitem>
337 </segmentedlist>
338
339 <variablelist>
340 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
341 <?dbfo list-presentation="list"?>
342 <?dbhtml list-presentation="table"?>
343
344 <!-- If the program or library name conflicts (is the same) as the
345 package name, add -prog or -lib to the varlistentry entity id
346 and the 2nd entry of the indexterm zone entity -->
347
348 <varlistentry id="lxdm-prog">
349 <term><command>lxdm</command></term>
350 <listitem>
351 <para>
352 is a script to execute <command>lxdm-binary</command>
353 </para>
354 <indexterm zone="lxdm lxdm-prog">
355 <primary sortas="b-lxdm">lxdm</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="lxdm-binary">
361 <term><command>lxdm-binary</command></term>
362 <listitem>
363 <para>
364 is the actual Display Manager; needs to be executed with option
365 <option>-d</option> to daemonize
366 </para>
367 <indexterm zone="lxdm lxdm-binary">
368 <primary sortas="b-lxdm-binary">lxdm-binary</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="lxdm-config-prog">
374 <term><command>lxdm-config</command></term>
375 <listitem>
376 <para>
377 is a graphical customizing program
378 </para>
379 <indexterm zone="lxdm lxdm-config">
380 <primary sortas="b-lxdm">lxdm</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 </variablelist>
386
387 </sect2>
388
389</sect1>
Note: See TracBrowser for help on using the repository browser.