source: lxde/apps/lxdm.xml@ 10f84304

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 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 10f84304 was 10f84304, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Modify /etc/lxdm/lxdm.conf to include XORG_PREFIX, which may be different
from /usr. Slightly modified from Bruce's suggestion.

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