source: lxde/apps/lxdm.xml@ acc0c06

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

Recommend ConsoleKit-0.4.6 to LXDM-0.5.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@14157 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="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=/lib/systemd/system &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 </sect2>
146
147 <!--Optional section-->
148 <sect2 role="commands">
149 <title>Command Explanations</title>
150
151 <para>
152 <command>cat &gt; pam/lxdm &lt;&lt; "EOF" ...</command>: Replace default
153 <filename>/etc/pam.d/lxdm</filename> by another one appropriate for BLFS.
154 </para>
155
156 <para>
157 <command>sed -i ... lxdm.conf.in</command>: Fix the background to the
158 default one.
159 </para>
160
161 <para>
162 <option>--with-pam</option>: This option enables use of pam
163 authentication.
164 </para>
165
166 <para>
167 <option>--with-systemdsystemunitdir=no</option>: Main BLFS does not
168 support systemd.
169 </para>
170
171 </sect2>
172
173 <sect2 role="configuration">
174 <title>Configuring LXDM</title>
175
176 <sect3 id="lxdm-config">
177 <title>Config Files</title>
178
179 <para>
180 <filename>/etc/lxdm/lxdm.conf</filename>
181 </para>
182
183 <indexterm zone="lxdm lxdm-config">
184 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
185 </indexterm>
186
187 </sect3>
188
189 <sect3>
190 <title>Configuration Information</title>
191
192 <para>
193 The LXDM daemon configuration <filename>/etc/lxdm/lxdm.conf</filename>
194 file options includes numlock on/off, backgraound image (bg), session,
195 etc. You can set a default session by uncommenting the line:
196 session=/usr/bin/startlxde and replacing <command>startlxde</command>
197 with your session of choice. For <application>GNOME</application>
198 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
199 session=/usr/bin/openbox-session and for
200 <application>XFCE</application> session=/usr/bin/startxfce4.
201 </para>
202
203 <para>
204 It is also possible to set the preferred session on a per-user basis by
205 editing the ~/.dmrc file for each user and adding:
206 <screen><literal>[Desktop]
207 Session=xfce</literal></screen>
208 </para>
209
210 <para>
211 You can replace the default dummy face in the greeting screen by other
212 image representing your user. For that, copy or symlink the desired
213 image to your home directory, with the name <filename>.face</filename>.
214 </para>
215
216 </sect3>
217
218 <sect3 id="lxdm-init">
219 <title>Boot Script</title>
220
221 <para>
222 Install the <filename>/etc/rc.d/init.d/lxdm</filename> init script from
223 the <xref linkend="bootscripts"/> package.
224 </para>
225
226 <indexterm zone="lxdm lxdm-init">
227 <primary sortas="f-lxdm">lxdm</primary>
228 </indexterm>
229
230<screen role="root"><userinput>make install-lxdm</userinput></screen>
231
232 </sect3>
233
234 </sect2>
235 <!--Required section-->
236 <sect2 role="content">
237 <title>Contents</title>
238
239 <segmentedlist>
240 <segtitle>Installed Programs</segtitle>
241 <segtitle>Installed Libraries</segtitle>
242 <segtitle>Installed Directories</segtitle>
243
244 <seglistitem>
245 <seg>
246 lxdm, lxdm-binary and lxdm-config
247 </seg>
248 <seg>
249 None
250 </seg>
251 <seg>
252 /etc/lxdm and
253 /usr/share/lxdm
254 </seg>
255 </seglistitem>
256 </segmentedlist>
257
258 <variablelist>
259 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
260 <?dbfo list-presentation="list"?>
261 <?dbhtml list-presentation="table"?>
262
263 <!-- If the program or library name conflicts (is the same) as the
264 package name, add -prog or -lib to the varlistentry entity id
265 and the 2nd entry of the indexterm zone entity -->
266
267 <varlistentry id="lxdm-prog">
268 <term><command>lxdm</command></term>
269 <listitem>
270 <para>
271 is a script to execute <command>lxdm-binary</command>
272 </para>
273 <indexterm zone="lxdm lxdm-prog">
274 <primary sortas="b-lxdm">lxdm</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="lxdm-bin">
280 <term><command>lxdm-binary</command></term>
281 <listitem>
282 <para>
283 is the actual Display Manager; needs to be executed with option
284 <option>-d</option> to daemonize
285 </para>
286 <indexterm zone="lxdm lxdm-bin">
287 <primary sortas="b-lxdm">lxdm</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="lxdm-config-prog">
293 <term><command>lxdm-config</command></term>
294 <listitem>
295 <para>
296 is a graphical customizing program
297 </para>
298 <indexterm zone="lxdm lxdm-config">
299 <primary sortas="b-lxdm">lxdm</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303 </variablelist>
304 </sect2>
305</sect1>
Note: See TracBrowser for help on using the repository browser.