source: lxde/apps/lxdm.xml@ 761b96b

10.0 10.1 11.0 7.10 7.6 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 upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 761b96b was 761b96b, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Pidgin-2.10.9 and LXDM-0.5.0: fixes.

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