source: x/dm/lxdm.xml@ f1ce80b

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f1ce80b was f1ce80b, checked in by DJ Lucas <dj@…>, 5 years ago

[systemd-merge] - Section II layout

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

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