source: lxde/apps/lxdm.xml@ 2bda661

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

Add LXDM-0.5.0, copied, modified, from BLFS systemd branch.

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

  • Property mode set to 100644
File size: 8.5 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="linux-pam"/>
92 </para>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="gtk3"/>
97 </para>
98
99 <para condition="html" role="usernotes">
100 User Notes: <ulink url="&blfs-wiki;/lxdm"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of LXDM</title>
106
107 <para>
108 First, fix some files.
109 </para>
110
111<screen><userinput>mv -vi pam/lxdm{,.orig} &amp;&amp;
112
113cat &gt; pam/lxdm &lt;&lt; "EOF" &amp;&amp;
114<literal>#%PAM-1.0
115auth required pam_unix.so
116auth requisite pam_nologin.so
117account required pam_unix.so
118password required pam_unix.so
119session required pam_unix.so</literal>
120EOF
121
122sed -i 's/^bg/#&amp;/' data/lxdm.conf.in</userinput></screen>
123
124 <para>
125 Install <application>LXDM</application> by running the following
126 commands:
127 </para>
128
129<screen><userinput>./configure --prefix=/usr \
130 --sysconfdir=/etc \
131 --with-pam \
132 --with-systemdsystemunitdir=/lib/systemd/system &amp;&amp;
133make</userinput></screen>
134
135 <para>
136 This package does not come with a test suite.
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>make install</userinput></screen>
144 </sect2>
145
146 <!--Optional section-->
147 <sect2 role="commands">
148 <title>Command Explanations</title>
149
150 <para>
151 <command>cat &gt; pam/lxdm &lt;&lt; "EOF" ...</command>: Replace default
152 <filename>/etc/pam.d/lxdm</filename> by another one appropriate for BLFS.
153 </para>
154
155 <para>
156 <command>sed -i ... lxdm.conf.in</command>: Fix the background to the
157 default one.
158 </para>
159
160 <para>
161 <option>--with-pam</option>: This option enables use of pam
162 authentication.
163 </para>
164
165 <para>
166 <option>--with-systemdsystemunitdir=no</option>: Main BLFS does not
167 support systemd.
168 </para>
169
170 </sect2>
171
172 <sect2 role="configuration">
173 <title>Configuring LXDM</title>
174
175 <sect3 id="lxdm-config">
176 <title>Config Files</title>
177
178 <para>
179 <filename>/etc/lxdm/lxdm.conf</filename>
180 </para>
181
182 <indexterm zone="lxdm lxdm-config">
183 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
184 </indexterm>
185
186 </sect3>
187
188 <sect3>
189 <title>Configuration Information</title>
190
191 <para>
192 The LXDM daemon configuration <filename>/etc/lxdm/lxdm.conf</filename>
193 file options includes numlock on/off, backgraound image (bg), session,
194 etc. You can set a default session by uncommenting the line:
195 session=/usr/bin/startlxde and replacing <command>startlxde</command>
196 with your session of choice. For <application>GNOME</application>
197 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
198 session=/usr/bin/openbox-session and for
199 <application>XFCE</application> session=/usr/bin/startxfce4.
200 </para>
201
202 <para>
203 It is also possible to set the preferred session on a per-user basis by
204 editing the ~/.dmrc file for each user and adding:
205 <screen><literal>[Desktop]
206 Session=xfce</literal></screen>
207 </para>
208
209 <para>
210 You can replace the default dummy face in the greeting screen by other
211 image representing your user. For that, copy or symlink the desired
212 image to your home directory, with the name <filename>.face</filename>.
213 </para>
214
215 </sect3>
216
217 <sect3 id="lxdm-init">
218 <title>Boot Script</title>
219
220 <para>
221 Install the <filename>/etc/rc.d/init.d/lxdm</filename> init script from
222 the <xref linkend="bootscripts"/> package.
223 </para>
224
225 <indexterm zone="lxdm lxdm-init">
226 <primary sortas="f-lxdm">lxdm</primary>
227 </indexterm>
228
229<screen role="root"><userinput>make install-lxdm</userinput></screen>
230
231 </sect3>
232
233 </sect2>
234 <!--Required section-->
235 <sect2 role="content">
236 <title>Contents</title>
237
238 <segmentedlist>
239 <segtitle>Installed Programs</segtitle>
240 <segtitle>Installed Libraries</segtitle>
241 <segtitle>Installed Directories</segtitle>
242
243 <seglistitem>
244 <seg>
245 lxdm, lxdm-binary and lxdm-config
246 </seg>
247 <seg>
248 None
249 </seg>
250 <seg>
251 /etc/lxdm and
252 /usr/share/lxdm
253 </seg>
254 </seglistitem>
255 </segmentedlist>
256
257 <variablelist>
258 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
259 <?dbfo list-presentation="list"?>
260 <?dbhtml list-presentation="table"?>
261
262 <!-- If the program or library name conflicts (is the same) as the
263 package name, add -prog or -lib to the varlistentry entity id
264 and the 2nd entry of the indexterm zone entity -->
265
266 <varlistentry id="lxdm-prog">
267 <term><command>lxdm</command></term>
268 <listitem>
269 <para>
270 is a script to execute <command>lxdm-binary</command>
271 </para>
272 <indexterm zone="lxdm lxdm-prog">
273 <primary sortas="b-lxdm">lxdm</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="lxdm-bin">
279 <term><command>lxdm-binary</command></term>
280 <listitem>
281 <para>
282 is the actual Display Manager; needs to be executed with option
283 <option>-d</option> to daemonize
284 </para>
285 <indexterm zone="lxdm lxdm-bin">
286 <primary sortas="b-lxdm">lxdm</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="lxdm-config-prog">
292 <term><command>lxdm-config</command></term>
293 <listitem>
294 <para>
295 is a graphical customizing program
296 </para>
297 <indexterm zone="lxdm lxdm-config">
298 <primary sortas="b-lxdm">lxdm</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302 </variablelist>
303 </sect2>
304</sect1>
Note: See TracBrowser for help on using the repository browser.