source: x/dm/lxdm.xml@ 52250565

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 52250565 was 52250565, checked in by Pierre Labastie <pieere@…>, 2 years ago

Various clean-up and modifications to the dm pages in view of the recent
change to the bootscripts.

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

  • Property mode set to 100644
File size: 11.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 <!ENTITY lxdm-download-http "&sourceforge-dl;/lxdm/lxdm-&lxdm-version;.tar.xz">
8 <!ENTITY lxdm-download-ftp " ">
9 <!ENTITY lxdm-md5sum "061caae432634e6db38bbdc84bc6ffa0">
10 <!ENTITY lxdm-size "236 KB">
11 <!ENTITY lxdm-buildsize "5.6 MB">
12 <!ENTITY lxdm-time "less than 0.1 SBU ">
13]>
14
15<sect1 id="lxdm" xreflabel="lxdm-&lxdm-version;">
16 <?dbhtml filename="lxdm.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>lxdm-&lxdm-version;</title>
24
25 <indexterm zone="lxdm">
26 <primary sortas="a-lxdm">lxdm</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to LXDM</title>
31
32 <para>
33 The <application>LXDM</application> is a lightweight Display Manager for
34 the <application>LXDE</application> desktop. It can also be used as an
35 alternative to other Display Managers such as
36 <application>GNOME's</application> <application>GDM</application> or
37 <application>LightDM</application>.
38 </para>
39
40 &lfs10_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&lxdm-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&lxdm-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &lxdm-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &lxdm-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &lxdm-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &lxdm-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">LXDM Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="gtk2"/>,
81 <xref linkend="iso-codes"/>, and
82 <xref role="runtime" linkend="librsvg"/> (runtime, for default theme
83 background)
84 </para>
85
86 <bridgehead renderas="sect4">Recommended</bridgehead>
87 <para role="recommended">
88 <xref linkend="lxsession"/> (for <application>lxpolkit</application>) or
89 <xref role="nodep" linkend="polkit-gnome"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="gtk3"/>
95 </para>
96
97 <para condition="html" role="usernotes">
98 User Notes: <ulink url="&blfs-wiki;/lxdm"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of LXDM</title>
104
105 <para>
106 First, some fixes.
107 </para>
108
109<screen><userinput>cat &gt; pam/lxdm &lt;&lt; "EOF"
110<literal># Begin /etc/pam.d/lxdm
111
112auth requisite pam_nologin.so
113auth required pam_env.so
114auth required pam_succeed_if.so uid >= 1000 quiet
115auth include system-auth
116
117account include system-account
118
119password include system-password
120
121session required pam_limits.so
122session include system-session
123
124# End /etc/pam.d/lxdm</literal>
125EOF
126
127sed -i 's:sysconfig/i18n:profile.d/i18n.sh:g' data/lxdm.in &amp;&amp;
128sed -i 's:/etc/xprofile:/etc/profile:g' data/Xsession &amp;&amp;
129sed -e 's/^bg/#&amp;/' \
130 -e '/reset=1/ s/# //' \
131 -e 's/logou$/logout/' \
132 -e "/arg=/a arg=$XORG_PREFIX/bin/X" \
133 -i data/lxdm.conf.in</userinput></screen>
134
135 <para>
136 Install <application>LXDM</application> by running the following
137 commands:
138 </para>
139
140<screen revision="sysv"><userinput>./configure --prefix=/usr \
141 --sysconfdir=/etc \
142 --with-pam \
143 --with-systemdsystemunitdir=no &amp;&amp;
144make</userinput></screen>
145
146<screen revision="systemd"><userinput>./configure --prefix=/usr \
147 --sysconfdir=/etc \
148 --with-pam \
149 --with-systemdsystemunitdir=/lib/systemd/system &amp;&amp;
150make</userinput></screen>
151
152 <para>
153 This package does not come with a test suite.
154 </para>
155
156 <para>
157 Now, as the <systemitem class="username">root</systemitem> user:
158 </para>
159
160<screen role="root"><userinput>make install</userinput></screen>
161
162 </sect2>
163
164 <!--Optional section-->
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para>
169 <command>cat &gt; pam/lxdm &lt;&lt; "EOF" ...</command>: Replace default
170 <filename>/etc/pam.d/lxdm</filename> by another one appropriate for BLFS.
171 </para>
172
173 <para>
174 <command>sed -i ... data/lxdm.conf.in</command>: Modifications in the
175 default configuration:
176 (1) fix the background to the default one;
177 (2) restart X when session is close;
178 (3) typo; and
179 (4) include <envar>XORG_PREFIX</envar>, which may be different from
180 <filename class="directory">/usr</filename>.
181 </para>
182
183 <para>
184 <command>sed -i ... data/Xsession</command>: Source
185 <filename>/etc/profile</filename>, instead of other file, according to
186 BLFS standard.
187 </para>
188
189 <para>
190 <command>sed -i ... data/lxdm.in</command>: Fix greeter's locale for BLFS
191 specification.
192 </para>
193
194 <para>
195 <parameter>--with-pam</parameter>: This parameter enables use of pam
196 authentication.
197 </para>
198
199 <para revision="sysv">
200 <parameter>--with-systemdsystemunitdir=no</parameter>: BLFS does not
201 support systemd.
202 </para>
203
204 </sect2>
205
206 <sect2 role="configuration">
207 <title>Configuring LXDM</title>
208
209 <sect3 id="lxdm-config">
210 <title>Config Files</title>
211
212 <para>
213 <filename>/etc/lxdm/lxdm.conf</filename>
214 </para>
215
216 <indexterm zone="lxdm lxdm-config">
217 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
218 </indexterm>
219
220 </sect3>
221
222 <sect3 id="lxdm-init">
223 <title><phrase revision="sysv">Boot Script</phrase>
224 <phrase revision="systemd">Systemd Unit</phrase></title>
225
226 <indexterm zone="lxdm lxdm-init">
227 <primary sortas="f-lxdm">lxdm</primary>
228 </indexterm>
229
230 <para revision="sysv">
231 To start <command>lxdm</command> automatically when the system is
232 switched to runlevel 5, install the
233 <filename>/etc/rc.d/init.d/xdm</filename> script and the
234 <filename>/etc/sysconfig/xdm</filename> configuration file
235 included in the <xref linkend="bootscripts"/> package
236 and adjust <filename>/etc/inittab</filename> by running
237 as the <systemitem class="username">root</systemitem> user:
238 </para>
239
240<screen role="root" revision="sysv"><userinput>make install-lxdm</userinput></screen>
241
242 <para revision="systemd">
243 To start <application>LXDM</application> at boot execute the following
244 command as the <systemitem class="username">root</systemitem> user:
245 </para>
246
247<screen role="root" revision="systemd"><userinput>systemctl enable lxdm</userinput></screen>
248
249 </sect3>
250
251 <sect3>
252 <title>Configuration Information</title>
253
254 <para>
255 The LXDM daemon configuration file
256 (<filename>/etc/lxdm/lxdm.conf</filename>) specifies options that
257 include numlock on/off, background image (bg), session, etc. You can
258 set a default session by uncommenting the line:
259 session=/usr/bin/startlxde and replacing <command>startlxde</command>
260 with your session of choice. For <application>GNOME</application>
261 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
262 session=/usr/bin/openbox-session and for
263 <application>XFCE</application> session=/usr/bin/startxfce4.
264 </para>
265
266 <para>
267 It is also possible to set the preferred session on a per-user basis by
268 editing the ~/.dmrc file for each user and adding:
269 <screen><literal>[Desktop]
270 Session=xfce</literal></screen>
271 </para>
272
273 <para>
274 You can replace the default dummy face in the greeting screen by another
275 image representing your user. For that, copy or symlink the desired
276 image to your home directory with the name <filename>.face</filename>.
277 </para>
278
279 </sect3>
280
281 <sect3 revision="sysv">
282 <title>Starting lxdm</title>
283
284 <para>
285 The <command>lxdm</command> greeter can be started from the command
286 line as the <systemitem class="username">root</systemitem> user:
287 </para>
288
289<screen role="root"><userinput>telinit 5</userinput></screen>
290
291 <para>
292 Alternatively the runlevel can be permanently set to 5, starting the
293 <command>lxdm</command> greeter screen automatically, by modifying
294 <filename>/etc/inittab</filename>. As the <systemitem
295 class="username">root</systemitem> user:
296 </para>
297
298<screen role="root"><userinput>cp -v /etc/inittab{,-orig} &amp;&amp;
299sed -i '/initdefault/ s/3/5/' /etc/inittab</userinput></screen>
300
301 <note>
302 <para>
303 One important script, executed after login is
304 <filename>/etc/lxdm/Xsession</filename> which we have fixed to fit
305 BLFS specifications.
306 </para>
307 </note>
308
309 </sect3>
310
311 </sect2>
312
313 <sect2 role="content">
314 <title>Contents</title>
315
316 <segmentedlist>
317 <segtitle>Installed Programs</segtitle>
318 <segtitle>Installed Libraries</segtitle>
319 <segtitle>Installed Directories</segtitle>
320
321 <seglistitem>
322 <seg>
323 lxdm, lxdm-binary and lxdm-config
324 </seg>
325 <seg>
326 None
327 </seg>
328 <seg>
329 /etc/lxdm and
330 /usr/share/lxdm
331 </seg>
332 </seglistitem>
333 </segmentedlist>
334
335 <variablelist>
336 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
337 <?dbfo list-presentation="list"?>
338 <?dbhtml list-presentation="table"?>
339
340 <varlistentry id="lxdm-prog">
341 <term><command>lxdm</command></term>
342 <listitem>
343 <para>
344 is a script to execute <command>lxdm-binary</command>
345 </para>
346 <indexterm zone="lxdm lxdm-prog">
347 <primary sortas="b-lxdm">lxdm</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="lxdm-binary">
353 <term><command>lxdm-binary</command></term>
354 <listitem>
355 <para>
356 is the actual Display Manager; needs to be executed with option
357 <option>-d</option> to daemonize
358 </para>
359 <indexterm zone="lxdm lxdm-binary">
360 <primary sortas="b-lxdm-binary">lxdm-binary</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="lxdm-config-prog">
366 <term><command>lxdm-config</command></term>
367 <listitem>
368 <para>
369 is a graphical customizing program
370 </para>
371 <indexterm zone="lxdm lxdm-config">
372 <primary sortas="b-lxdm">lxdm</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 </variablelist>
378
379 </sect2>
380
381</sect1>
Note: See TracBrowser for help on using the repository browser.