source: lxde/apps/lxdm.xml@ a85c6ce

10.0 10.1 11.0 7.10 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 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 a85c6ce was 6a5aa22, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Update to colord-1.2.4.
LXDM-0.5.0: remove ' -background vt1' from default BLFS configuration, to not hiding bootscripts actions at shutdown/reboot.

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

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