source: lxde/apps/lxdm-systemd.xml@ d11d80f

7.6-blfs 7.6-systemd kde5-14686 systemd-13485
Last change on this file since d11d80f was d11d80f, checked in by Christopher Gregory <cjg@…>, 10 years ago

Corrected awk statement on lxdm page and changed its location till after install added runtime dependancy.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@14283 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.2 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://distfiles.alpinelinux.org/distfiles/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.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: cjg $</othername>
24 <date>$Date: 2014-08-31 16:03:10 +1200 (Sun, 31 Aug 2014) $</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
38 lightweight display manager for the <application>LXDE</application> desktop. It can also be used as an
39 alternative to <application>GNOME's</application> <application>GDM</application> or
40 <application>KDE's</application> <application>KDM</application>.
41 </para>
42
43 &lfs76_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>
49 Download (HTTP): <ulink url="&lxdm-download-http;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download (FTP): <ulink url="&lxdm-download-ftp;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download MD5 sum: &lxdm-md5sum;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download size: &lxdm-size;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated disk space required: &lxdm-buildsize;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated build time: &lxdm-time;
75 </para>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">LXDM Dependencies</bridgehead>
80
81 <bridgehead renderas="sect4">Required</bridgehead>
82 <para role="required">
83 <xref linkend="gtk2"/>
84 <xref linkend="iso-codes"/> and
85 <xref linkend="librsvg"/> (runtime, for default theme background)
86 </para>
87
88 <bridgehead renderas="sect4">Recommended</bridgehead>
89 <para role="recommended">
90 <xref linkend="linux-pam"/>
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="gtk3"/>
96 </para>
97
98 <para condition="html" role="usernotes">
99 User Notes: <ulink url="&blfs-wiki;/lxdm"/>
100 </para>
101 </sect2>
102
103 <sect2 role="installation">
104 <title>Installation of LXDM</title>
105
106 <para>
107 Install <application>LXDM</application> by running the following
108 commands:
109 </para>
110
111<screen><userinput>./configure --prefix=/usr \
112 --sysconfdir=/etc \
113 --with-pam \
114 --disable-consolekit \
115 --with-systemdsystemunitdir=/lib/systemd/system &amp;&amp;
116make</userinput></screen>
117
118 <para>
119 This package does not come with a test suite.
120 </para>
121
122 <para>
123 Now, as the <systemitem class="username">root</systemitem> user:
124 </para>
125
126<screen role="root"><userinput>make install &amp;&amp;
127sed -e "/pam_selinux.so/d" -i pam/lxdm &amp;&amp;
128awk '/system-auth/{c++;if(c==2){sub("system-auth","system-account");}}1' pam/lxdm 2&gt;&amp;1 | tee /etc/pam.d/lxdm</userinput></screen>
129 </sect2>
130
131 <!--Optional section-->
132 <sect2 role="commands">
133 <title>Command Explanations</title>
134 <para>
135 <command>sed -e "/pam_selinux.so/d" -i pam/lxdm</command>: This command removes
136 the selinux pam module as selinux is not part of blfs.
137 </para>
138
139 <para>
140 <command>awk '/system-auth/{c++;if(c==2){sub("system-auth","system-account");}}1'</command>:
141 This command repaces the second instance of system-auth with system-account to make logind
142 work correctly.
143 </para>
144
145 <para>
146 <option>--with-pam</option>: This option enables use of pam authentication.
147 </para>
148
149 <para>
150 <option>--disable-consolekit</option>: This option disables the use of
151 <application>consolekit</application> as it is not used on a
152 <application>systemd</application> system.
153 </para>
154
155 <para>
156 <option>--with-systemdsystemunitdir=/lib/systemd/system</option>: This option
157 ensures that the systemd unit file gets installed in the correct location.
158 </para>
159
160 </sect2>
161
162 <sect2 role="configuration">
163 <title>Configuring LXDM</title>
164
165 <sect3 id="lxdm-config">
166 <title>Config Files</title>
167
168 <para>
169 <filename>/etc/lxdm/lxdm.conf</filename>
170 </para>
171
172 <indexterm zone="lxdm lxdm-config">
173 <primary sortas="e-etc-lxdm-lxdm.conf">/etc/lxdm/lxdm.conf</primary>
174 </indexterm>
175
176 </sect3>
177
178 <sect3>
179 <title>Configuration Information</title>
180
181 <para>
182 The LXDM daemon is configured using the
183 <filename>/etc/lxdm/lxdm.conf</filename> file.
184 Within this file you can set a default session by uncommenting
185 the line: session=/usr/bin/startlxde and replacing startlxde
186 with your session of choice. For <application>GNOME</application>
187 session=/usr/bin/gnome-session. For <application>OPENBOX</application>
188 session=/usr/bin/openbox-session and for <application>XFCE</application>
189 session=/usr/bin/startxfce4.
190 </para>
191
192 <para>
193 It is also possible to set the preferred session on a per-user basis by
194 editing the ~/.dmrc file for each user and adding:
195 <screen><literal>
196 [Desktop]
197 Session=xfce</literal></screen>
198 </para>
199
200 <para>
201 To prevent the possibility of lxdm not cleanly logging out a users session
202 add the following to the <filename>/etc/lxdm/PostLogout</filename> as the
203 <systemitem class="username">root</systemitem> user:
204 </para>
205
206<screen role="root"><userinput>cat &gt; /etc/lxdm/PostLogout &lt;&lt; "EOF"
207# Terminate current user session
208/bin/loginctl terminate-session $XDG_SESSION_ID
209
210# Restart lxdm
211/bin/systemctl restart lxdm.service
212EOF</userinput></screen>
213
214 </sect3>
215
216 <sect3 id="lxdm-init">
217 <title>Systemd Units</title>
218
219 <para>
220 To start the <command>LXDM</command> daemon at boot, enable
221 the previously installed systemd unit by running the following command
222 as the <systemitem class="username">root</systemitem> user:
223 </para>
224
225 <indexterm zone="lxdm lxdm-init">
226 <primary sortas="f-lxdm">lxdm</primary>
227 </indexterm>
228
229<screen role="root"><userinput>systemctl enable lxdm</userinput></screen>
230
231 </sect3>
232
233 </sect2>
234 <!--Required section-->
235 <sect2 role="content">
236 <title>Contents</title>
237
238 <segmentedlist>
239 <segtitle>Installed Programs</segtitle>
240 <segtitle>Installed Libraries</segtitle>
241 <segtitle>Installed Directories</segtitle>
242
243 <seglistitem>
244 <seg>
245 lxdm-config, lxdm and lxdm-binary.
246 </seg>
247 <seg>
248 None.
249 </seg>
250 <seg>
251 /etc/lxdm, /etc/pam.d, and
252 /usr/share/lxdm.
253 </seg>
254 </seglistitem>
255 </segmentedlist>
256
257 <variablelist>
258 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
259 <?dbfo list-presentation="list"?>
260 <?dbhtml list-presentation="table"?>
261
262 <!-- If the program or library name conflicts (is the same) as the
263 package name, add -prog or -lib to the varlistentry entity id
264 and the 2nd entry of the indexterm zone entity -->
265
266 <varlistentry id="lxdm-prog">
267 <term><command>lxdm</command></term>
268 <listitem>
269 <para>
270 Is the lxdm daeamon.
271 </para>
272 <indexterm zone="lxdm lxdm-prog">
273 <primary sortas="b-lxdm">lxdm</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277 </variablelist>
278 </sect2>
279</sect1>
Note: See TracBrowser for help on using the repository browser.