source: lxde/apps/lxdm.xml@ cf694de

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

LXDM-0.5.0 fixes: typo and some rewriting. Fix again localization, Thanks Armin K.

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

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