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

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 3f460da0 was 3f460da0, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Tag Weston
Fix URLs in KF5
(systemd) Fix instructions for LXDM, XFCE4-SESSION, Plasma5, and LxQT

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

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