source: lxde/apps/lxdm.xml@ f3979ba

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

Update to exempi-2.2.2.
Update to libunistring-0.9.4.
Update to lxde-common-0.5.6.
Update to iso-codes-3.56.
Update to appstream-glib-0.3.0.
LXDM-0.5.0 fixes: typo in configure, localization and starting.

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

  • Property mode set to 100644
File size: 10.1 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, fix some files.
110 </para>
111
112<screen><userinput>mv -vi pam/lxdm{,.orig} &amp;&amp;
113
114cat &gt; pam/lxdm &lt;&lt; "EOF" &amp;&amp;
115<literal>#%PAM-1.0
116auth required pam_unix.so
117auth requisite pam_nologin.so
118account required pam_unix.so
119password required pam_unix.so
120session required pam_unix.so</literal>
121EOF
122
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 ... lxdm.conf.in</command>: Fix the background to the
159 default one.
160 </para>
161
162 <para>
163 <option>--with-pam</option>: This option enables use of pam
164 authentication.
165 </para>
166
167 <para>
168 <option>--with-systemdsystemunitdir=no</option>: BLFS does not support
169 systemd.
170 </para>
171
172 </sect2>
173
174 <sect2 role="configuration">
175 <title>Configuring LXDM</title>
176
177 <sect3 id="lxdm-config">
178 <title>Config Files</title>
179
180 <para>
181 <filename>/etc/lxdm/lxdm.conf</filename>
182 </para>
183
184 <indexterm zone="lxdm lxdm-config">
185 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
186 </indexterm>
187
188 </sect3>
189
190 <sect3>
191 <title>Configuration Information</title>
192
193 <para>
194 The LXDM daemon configuration <filename>/etc/lxdm/lxdm.conf</filename>
195 file options includes numlock on/off, backgraound image (bg), session,
196 etc. You can set a default session by uncommenting the line:
197 session=/usr/bin/startlxde and replacing <command>startlxde</command>
198 with your session of choice. For <application>GNOME</application>
199 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
200 session=/usr/bin/openbox-session and for
201 <application>XFCE</application> session=/usr/bin/startxfce4.
202 </para>
203
204 <para>
205 It is also possible to set the preferred session on a per-user basis by
206 editing the ~/.dmrc file for each user and adding:
207 <screen><literal>[Desktop]
208 Session=xfce</literal></screen>
209 </para>
210
211 <para>
212 You can replace the default dummy face in the greeting screen by other
213 image representing your user. For that, copy or symlink the desired
214 image to your home directory, with the name <filename>.face</filename>.
215 </para>
216
217 </sect3>
218
219 <sect3>
220 <title>Localization</title>
221
222 <para>
223 If you wish <command>lxdm</command> greeter in your native language,
224 for non-English speakers, a fix is necessary, as <systemitem
225 class="username">root</systemitem> user:
226 </para>
227
228<screen role="root"><userinput>sed -i '1a\\nexport <replaceable>&lt;your_LANG&gt;</replaceable>' /usr/sbin/lxdm</userinput></screen>
229
230 <para>
231 where the value to be used in
232 <replaceable>&lt;your_LANG&gt;</replaceable> is the same you obtain with
233 <command>echo $LANG</command> command.
234 </para>
235
236 </sect3>
237
238 <sect3>
239 <title>Starting lxdm</title>
240
241 <para>
242 You can manually start <command>lxdm</command>, e.g, if you install the
243 bootscript, by running, as <systemitem
244 class="username">root</systemitem> user:
245 </para>
246
247<screen role="root"><userinput>/etc/rc.d/init.d/lxdm start</userinput></screen>
248
249 <para>
250 Another option, change to runlevel 5, as <systemitem
251 class="username">root</systemitem> user:
252 </para>
253
254<screen role="root"><userinput>init 5</userinput></screen>
255
256 <para>
257 Runlevel 5 is necessary, by definition. However, BLFS default is
258 runlevel 3. To permanently change the default to 5, thus obtaining
259 the <command>lxdm</command> greeter screen automatically, you need to
260 modify <filename>/etc/inittab</filename>, as <systemitem
261 class="username">root</systemitem> user:
262 </para>
263
264<screen role="root"><userinput>mov -vi /etc/inittab{,-orig} &amp;&amp;
265sed -i '/initdefault/ s/3/5/' /etc/inittab</userinput></screen>
266
267 </sect3>
268
269 <sect3 id="lxdm-init">
270 <title>Boot Script</title>
271
272 <para>
273 Install the <filename>/etc/rc.d/init.d/lxdm</filename> init script from
274 the <xref linkend="bootscripts"/> package.
275 </para>
276
277 <indexterm zone="lxdm lxdm-init">
278 <primary sortas="f-lxdm">lxdm</primary>
279 </indexterm>
280
281<screen role="root"><userinput>make install-lxdm</userinput></screen>
282
283 </sect3>
284
285 </sect2>
286 <!--Required section-->
287 <sect2 role="content">
288 <title>Contents</title>
289
290 <segmentedlist>
291 <segtitle>Installed Programs</segtitle>
292 <segtitle>Installed Libraries</segtitle>
293 <segtitle>Installed Directories</segtitle>
294
295 <seglistitem>
296 <seg>
297 lxdm, lxdm-binary and lxdm-config
298 </seg>
299 <seg>
300 None
301 </seg>
302 <seg>
303 /etc/lxdm and
304 /usr/share/lxdm
305 </seg>
306 </seglistitem>
307 </segmentedlist>
308
309 <variablelist>
310 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
311 <?dbfo list-presentation="list"?>
312 <?dbhtml list-presentation="table"?>
313
314 <!-- If the program or library name conflicts (is the same) as the
315 package name, add -prog or -lib to the varlistentry entity id
316 and the 2nd entry of the indexterm zone entity -->
317
318 <varlistentry id="lxdm-prog">
319 <term><command>lxdm</command></term>
320 <listitem>
321 <para>
322 is a script to execute <command>lxdm-binary</command>
323 </para>
324 <indexterm zone="lxdm lxdm-prog">
325 <primary sortas="b-lxdm">lxdm</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="lxdm-bin">
331 <term><command>lxdm-binary</command></term>
332 <listitem>
333 <para>
334 is the actual Display Manager; needs to be executed with option
335 <option>-d</option> to daemonize
336 </para>
337 <indexterm zone="lxdm lxdm-bin">
338 <primary sortas="b-lxdm">lxdm</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="lxdm-config-prog">
344 <term><command>lxdm-config</command></term>
345 <listitem>
346 <para>
347 is a graphical customizing program
348 </para>
349 <indexterm zone="lxdm lxdm-config">
350 <primary sortas="b-lxdm">lxdm</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354 </variablelist>
355 </sect2>
356</sect1>
Note: See TracBrowser for help on using the repository browser.