source: lxde/apps/lxdm.xml@ a6221fd

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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a6221fd was a6221fd, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

LXDM-0.5.0: tweaks.
Update to LLVM-3.5.0.
Update to mc-4.8.13.

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