source: x/dm/lightdm.xml@ 580ce98

11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 580ce98 was 580ce98, checked in by Ken Moffat <ken@…>, 3 years ago

Correct soem pcre dependencies which were outdated.

  • Property mode set to 100644
File size: 14.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<!-- lightdm -->
8 <!ENTITY lightdm-download-http "https://github.com/CanonicalLtd/lightdm/releases/download/&lightdm-version;/lightdm-&lightdm-version;.tar.xz">
9 <!ENTITY lightdm-download-ftp " ">
10 <!ENTITY lightdm-md5sum "c566ea595f2b81e68684be9f8dbcbb42">
11 <!ENTITY lightdm-size "500 KB">
12 <!ENTITY lightdm-buildsize "21 MB">
13 <!ENTITY lightdm-time "0.2 SBU ">
14
15<!-- lightdm-gtk-greeter -->
16 <!ENTITY lightdm-gtk-greeter-download-http "https://github.com/Xubuntu/lightdm-gtk-greeter/releases/download/lightdm-gtk-greeter-&lightdm-gtk-greeter-version;/lightdm-gtk-greeter-&lightdm-gtk-greeter-version;.tar.gz">
17 <!ENTITY lightdm-gtk-greeter-download-ftp " ">
18 <!ENTITY lightdm-gtk-greeter-md5sum "373c73c67367df511eb544e09a2da281">
19 <!ENTITY lightdm-gtk-greeter-size "569.7 KB">
20 <!ENTITY lightdm-gtk-greeter-buildsize "5.5 MB">
21 <!ENTITY lightdm-gtk-greeter-time "less than 0.1 SBU ">
22]>
23
24<sect1 id="lightdm" xreflabel="lightdm-&lightdm-version;">
25 <?dbhtml filename="lightdm.html"?>
26
27 <sect1info>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>lightdm-&lightdm-version;</title>
32
33 <indexterm zone="lightdm">
34 <primary sortas="a-lightdm">lightdm</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to Lightdm</title>
39
40 <para>
41 The <application>lightdm</application> package contains a lightweight
42 display manager based upon GTK.
43 </para>
44
45 &lfs110a_checked;
46
47 <bridgehead renderas="sect3">Lightdm Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>
51 Download (HTTP): <ulink url="&lightdm-download-http;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download (FTP): <ulink url="&lightdm-download-ftp;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download MD5 sum: &lightdm-md5sum;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download size: &lightdm-size;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated disk space required: &lightdm-buildsize;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated build time: &lightdm-time;
77 </para>
78 </listitem>
79 </itemizedlist>
80
81 <bridgehead renderas="sect3">Additional download</bridgehead>
82
83 <note>
84 <para>
85 The greeter is a program to present a graphical login screen. There
86 are several alternative greeters, but the gtk+ package is the reference
87 implementation. For a list of other greeters, see <ulink
88 url="https://en.wikipedia.org/wiki/LightDM"/>.
89 </para>
90 </note>
91
92 <itemizedlist spacing="compact">
93 <listitem>
94 <para>
95 Download (HTTP): <ulink url="&lightdm-gtk-greeter-download-http;"/>
96 </para>
97 </listitem>
98 <listitem>
99 <para>
100 Download (FTP): <ulink url="&lightdm-gtk-greeter-download-ftp;"/>
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Download MD5 sum: &lightdm-gtk-greeter-md5sum;
106 </para>
107 </listitem>
108 <listitem>
109 <para>
110 Download size: &lightdm-gtk-greeter-size;
111 </para>
112 </listitem>
113 <listitem>
114 <para>
115 Estimated disk space required: &lightdm-gtk-greeter-buildsize;
116 </para>
117 </listitem>
118 <listitem>
119 <para>
120 Estimated build time: &lightdm-gtk-greeter-time;
121 </para>
122 </listitem>
123 </itemizedlist>
124
125 <bridgehead renderas="sect3">Lightdm Dependencies</bridgehead>
126
127 <bridgehead renderas="sect4">Required</bridgehead>
128 <para role="required">
129 <xref linkend="exo"/> (for the greeter),
130<!-- required by exo <xref linkend="gtk3"/>, -->
131 <xref linkend="libgcrypt"/>,
132 <xref linkend="itstool"/>, and
133 <xref linkend="linux-pam"/>
134<!-- Neither lightdm-1.30.0 nor lightdm-gtk-greeter-2.0.8
135 mention pcre in their configure scripts
136 <xref linkend="pcre"/>-->
137 </para>
138
139 <bridgehead renderas="sect4">Recommended</bridgehead>
140 <para role="recommended">
141 <xref linkend="gobject-introspection"/>,
142 <xref linkend="libxklavier"/>, and
143 <xref linkend="vala"/>
144 </para>
145
146 <bridgehead renderas="sect4">Optional</bridgehead>
147 <para role="optional">
148 <xref role="runtime" linkend="accountsservice"/> (run time),
149 <xref linkend="at-spi2-core"/>,
150 <xref linkend="gtk-doc"/>,
151 <xref linkend="qt5"/>,
152 <ulink url="https://launchpad.net/ido">libido</ulink>, and
153 <ulink url="https://launchpad.net/libindicator">libindicator</ulink>
154
155 </para>
156
157 <para condition="html" role="usernotes">User Notes:
158 <ulink url="&blfs-wiki;/lightdm"/>
159 </para>
160 </sect2>
161
162 <sect2 role="installation">
163 <title>Installation of Lightdm</title>
164
165 <para>
166 First, create a dedicated user and group to take
167 control of the <command>lightdm</command> daemon after it is
168 started. Issue the following commands as the
169 <systemitem class="username">root</systemitem> user:
170 </para>
171
172<screen role="root"><userinput>groupadd -g 65 lightdm &amp;&amp;
173useradd -c "Lightdm Daemon" \
174 -d /var/lib/lightdm \
175 -u 65 -g lightdm \
176 -s /bin/false lightdm</userinput></screen>
177
178 <para revision="sysv">
179 Then change the <application>Linux-PAM</application> configuration files
180 so that <application>elogind</application> is used:
181 </para>
182
183<screen revision="sysv"><userinput>sed -i s/systemd/elogind/ data/pam/*</userinput></screen>
184
185 <para>
186 Install <application>lightdm</application> by running the following
187 commands:
188 </para>
189
190<screen><userinput>./configure \
191 --prefix=/usr \
192 --libexecdir=/usr/lib/lightdm \
193 --localstatedir=/var \
194 --sbindir=/usr/bin \
195 --sysconfdir=/etc \
196 --disable-static \
197 --disable-tests \
198 --with-greeter-user=lightdm \
199 --with-greeter-session=lightdm-gtk-greeter \
200 --docdir=/usr/share/doc/lightdm-&lightdm-version; &amp;&amp;
201make</userinput></screen>
202
203 <para>
204 This package does not come with a test suite.
205 </para>
206
207 <para>
208 Now, as the <systemitem class="username">root</systemitem> user:
209 </para>
210
211<screen role="root"><userinput>make install &amp;&amp;
212cp tests/src/lightdm-session /usr/bin &amp;&amp;
213sed -i '1 s/sh/bash --login/' /usr/bin/lightdm-session &amp;&amp;
214rm -rf /etc/init &amp;&amp;
215install -v -dm755 -o lightdm -g lightdm /var/lib/lightdm &amp;&amp;
216install -v -dm755 -o lightdm -g lightdm /var/lib/lightdm-data &amp;&amp;
217install -v -dm755 -o lightdm -g lightdm /var/cache/lightdm &amp;&amp;
218install -v -dm770 -o lightdm -g lightdm /var/log/lightdm</userinput></screen>
219
220 <para>
221 Now build the greeter:
222 </para>
223
224<screen><userinput>tar -xf ../lightdm-gtk-greeter-&lightdm-gtk-greeter-version;.tar.gz &amp;&amp;
225cd lightdm-gtk-greeter-&lightdm-gtk-greeter-version; &amp;&amp;
226
227./configure \
228 --prefix=/usr \
229 --libexecdir=/usr/lib/lightdm \
230 --sbindir=/usr/bin \
231 --sysconfdir=/etc \
232 --with-libxklavier \
233 --enable-kill-on-sigterm \
234 --disable-libido \
235 --disable-libindicator \
236 --disable-static \
237 --disable-maintainer-mode \
238 --docdir=/usr/share/doc/lightdm-gtk-greeter-&lightdm-gtk-greeter-version; &amp;&amp;
239
240make</userinput></screen>
241
242 <para>
243 Now, as the <systemitem class="username">root</systemitem> user:
244 </para>
245
246<screen role="root"><userinput>make install</userinput></screen>
247
248 <note>
249 <para>
250 If you installed Xorg in /opt, you will need to create a symbolic
251 link so lightdm can find the Xorg server. As the
252 <systemitem class="username">root</systemitem> user:
253 </para>
254
255 <screen><userinput>ln -sf /opt/xorg/bin/Xorg /usr/bin/X</userinput></screen>
256 </note>
257
258
259 </sect2>
260
261 <sect2 role="commands">
262 <title>Command Explanations</title>
263 <para>
264
265 <command>sed ... /usr/bin/lightdm-session</command>:
266 This command ensures that the initial login via the greeter sources
267 /etc/profile and ~/.bash_profile. Without this, commands that depend on
268 different environment variables may not work as expected.
269 </para>
270<!--
271 <para>
272 <parameter>ITSTOOL=/bin/true</parameter>: although
273 <xref linkend="itstool"/> is not needed in a normal build,
274 <command>configure</command> throws an error if it is not found on the
275 system. This parameter prevents the error.
276 </para>
277
278 <para>
279 <parameter>HAVE_EXO_CSOURCE=yes</parameter>: although
280 <command>exo-csource</command> is not needed in a normal build,
281 <command>configure</command> throws an error if it is not found on the
282 system. This parameter prevents the error.
283 </para>
284-->
285 </sect2>
286
287 <sect2 role="configuration">
288 <title>Configuring lightdm</title>
289
290 <sect3 id="lightdm-config">
291 <title>Config Files</title>
292
293 <para>
294 /etc/lightdm/{lightdm,users,keys}.conf
295 </para>
296
297 <indexterm zone="lightdm lightdm-config">
298 <primary sortas="e-etc-lightdm-lightdm.conf">/etc/lightdm/lightdm.conf</primary>
299 </indexterm>
300
301 <indexterm zone="lightdm lightdm-config">
302 <primary sortas="e-users.conf">/etc/lightdm/users.conf</primary>
303 </indexterm>
304
305 <indexterm zone="lightdm lightdm-config">
306 <primary sortas="e-keys.conf">/etc/lightdm/keys.conf</primary>
307 </indexterm>
308
309 <indexterm zone="lightdm lightdm-config">
310 <primary sortas="e-lightdm-gtk-greeter.conf">
311 /etc/lightdm/lightdm-gtk-greeter.conf</primary>
312 </indexterm>
313
314 </sect3>
315
316 <sect3 id="lightdm-bootscript">
317 <title><phrase revision="sysv">Boot Script</phrase>
318 <phrase revision="systemd">Systemd Unit</phrase></title>
319
320 <indexterm zone="lightdm lightdm-bootscript">
321 <primary sortas="f-lightdm">lightdm</primary>
322 </indexterm>
323
324 <para revision="sysv">
325 To start <command>lightdm</command> automatically when the system is
326 switched to runlevel 5, install the
327 <filename>/etc/rc.d/init.d/xdm</filename> script and the
328 <filename>/etc/sysconfig/xdm</filename> configuration file
329 included in the <xref linkend="bootscripts"/> package
330 and adjust <filename>/etc/inittab</filename> by running
331 as the <systemitem class="username">root</systemitem> user:
332 </para>
333
334<screen role="root" revision="sysv"><userinput>make install-lightdm</userinput></screen>
335
336 <para revision="systemd">
337 Install and enable the systemd unit. From the
338 <xref linkend="systemd-units"/> package:
339 </para>
340
341<screen role="root" revision="systemd"><userinput>make install-lightdm &amp;&amp;
342systemctl enable lightdm</userinput></screen>
343
344 </sect3>
345
346 <sect3 id="lightdm-init" revision="sysv">
347 <title>Starting lightdm</title>
348
349 <para>
350 The <command>lightdm</command> greeter can be started from the
351 command line as the <systemitem class="username">root</systemitem>
352 user:
353 </para>
354
355<screen role="root"><userinput>telinit 5</userinput></screen>
356
357 <para>
358 Alternatively the runlevel can be permanently set to 5, starting the
359 <command>lightdm</command> greeter screen automatically, by modifying
360 <filename>/etc/inittab</filename>. As the <systemitem
361 class="username">root</systemitem> user:
362 </para>
363
364<screen role="root"><userinput>cp -v /etc/inittab{,-orig} &amp;&amp;
365sed -i '/initdefault/ s/3/5/' /etc/inittab</userinput></screen>
366
367 </sect3>
368
369 <sect3 id="lightdm-sessions">
370 <title>Available Sessions</title>
371
372 <para>
373 The greeter offers a list of available sessions,
374 depending on the Window Managers and Desktop Environments installed. The
375 list includes sessions which have a corresponding
376 <filename>.desktop</filename> file installed under
377 <filename class="directory">/usr/share/xsessions</filename>. Most of the
378 Window Managers and Desktop Environments automatically provide those
379 files, but if necessary, you may include a custom one.
380 </para>
381
382 </sect3>
383
384 </sect2>
385
386 <sect2 role="content">
387 <title>Contents</title>
388
389 <segmentedlist>
390 <segtitle>Installed Programs</segtitle>
391 <segtitle>Installed Libraries</segtitle>
392 <segtitle>Installed Directories</segtitle>
393
394 <seglistitem>
395 <seg>
396 dm-tool,
397 lightdm, and
398 lightdm-gtk-greeter
399 </seg>
400 <seg>
401 liblightdm-gobject-1.so
402 </seg>
403 <seg>
404 /etc/lightdm,
405 /etc/apparmor.d,
406 /usr/lib/lightdm,
407 /usr/include/lightdm-gobject-1,
408 /usr/share/help/C/lightdm
409 /usr/share/gtk-doc/html/lightdm-gobject-1,
410 /usr/share/doc/lightdm-gtk-greeter-&lightdm-gtk-greeter-version;,
411 /var/lib/lightdm,
412 /var/lib/lightdm-data,
413 /var/cache/lightdm, and
414 /var/log/lightdm
415 </seg>
416 </seglistitem>
417 </segmentedlist>
418
419 <variablelist>
420 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
421 <?dbfo list-presentation="list"?>
422 <?dbhtml list-presentation="table"?>
423
424 <varlistentry id="lightdm-prog">
425 <term><command>lightdm</command></term>
426 <listitem>
427 <para>
428 is a display and login manager
429 </para>
430 <indexterm zone="lightdm lightdm-prog">
431 <primary sortas="b-lightdm">lightdm</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="lightdm-gtk-greeter">
437 <term><command>lightdm-gtk-greeter</command></term>
438 <listitem>
439 <para>
440 is an auxiliary process that displays the greeter,
441 a graphical user interface that performs user
442 authentication and initiates the selected window manager
443 or display environment
444 </para>
445 <indexterm zone="lightdm lightdm-gtk-greeter">
446 <primary sortas="b-lightdm-gtk-greeter">lightdm-gtk-greeter</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 </variablelist>
452
453 </sect2>
454
455</sect1>
Note: See TracBrowser for help on using the repository browser.