source: x/dm/lightdm.xml@ 5b1d11c

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 xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since 5b1d11c was 9a6f0ab3, checked in by Pierre Labastie <pierre.labastie@…>, 2 years ago

lightdm (sysv): make "telinit" "nodump"

otherwise, jhalfs switch runlevels, lightdm starts, and if the
libinput or event xorg driver is not built, you need to reboot.
Also remove some obsolete instructions about the inittab,
since they are now performed by "make install-lightdm"
  • Property mode set to 100644
File size: 14.6 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 &lfs111_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 role="nodump"><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 the <filename>lightdm.service</filename> unit included in
338 the <xref linkend="systemd-units"/> package:
339 </para>
340
341<screen role="root" revision="systemd"><userinput>make install-lightdm</userinput></screen>
342
343 </sect3>
344 <sect3 id="lightdm-init" revision="sysv">
345 <title>Starting lightdm</title>
346
347 <para>
348 The <command>lightdm</command> greeter can be started from the
349 command line as the <systemitem class="username">root</systemitem>
350 user:
351 </para>
352
353<screen role="nodump"><userinput>telinit 5</userinput></screen>
354
355<!-- "make install-lightdm already does this already
356 <para>
357 Alternatively the runlevel can be permanently set to 5, starting the
358 <command>lightdm</command> greeter screen automatically, by modifying
359 <filename>/etc/inittab</filename>. As the <systemitem
360 class="username">root</systemitem> user:
361 </para>
362
363<screen role="root"><userinput>cp -v /etc/inittab{,-orig} &amp;&amp;
364sed -i '/initdefault/ s/3/5/' /etc/inittab</userinput></screen>
365-->
366 </sect3>
367
368 <sect3 id="lightdm-sessions">
369 <title>Available Sessions</title>
370
371 <para>
372 The greeter offers a list of available sessions,
373 depending on the Window Managers and Desktop Environments installed. The
374 list includes sessions which have a corresponding
375 <filename>.desktop</filename> file installed under
376 <filename class="directory">/usr/share/xsessions</filename>. Most of the
377 Window Managers and Desktop Environments automatically provide those
378 files, but if necessary, you may include a custom one.
379 </para>
380
381 </sect3>
382
383 </sect2>
384
385 <sect2 role="content">
386 <title>Contents</title>
387
388 <segmentedlist>
389 <segtitle>Installed Programs</segtitle>
390 <segtitle>Installed Libraries</segtitle>
391 <segtitle>Installed Directories</segtitle>
392
393 <seglistitem>
394 <seg>
395 dm-tool,
396 lightdm, and
397 lightdm-gtk-greeter
398 </seg>
399 <seg>
400 liblightdm-gobject-1.so
401 </seg>
402 <seg>
403 /etc/lightdm,
404 /etc/apparmor.d,
405 /usr/lib/lightdm,
406 /usr/include/lightdm-gobject-1,
407 /usr/share/help/C/lightdm
408 /usr/share/gtk-doc/html/lightdm-gobject-1,
409 /usr/share/doc/lightdm-gtk-greeter-&lightdm-gtk-greeter-version;,
410 /var/lib/lightdm,
411 /var/lib/lightdm-data,
412 /var/cache/lightdm, and
413 /var/log/lightdm
414 </seg>
415 </seglistitem>
416 </segmentedlist>
417
418 <variablelist>
419 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
420 <?dbfo list-presentation="list"?>
421 <?dbhtml list-presentation="table"?>
422
423 <varlistentry id="lightdm-prog">
424 <term><command>lightdm</command></term>
425 <listitem>
426 <para>
427 is a display and login manager
428 </para>
429 <indexterm zone="lightdm lightdm-prog">
430 <primary sortas="b-lightdm">lightdm</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="lightdm-gtk-greeter">
436 <term><command>lightdm-gtk-greeter</command></term>
437 <listitem>
438 <para>
439 is an auxiliary process that displays the greeter,
440 a graphical user interface that performs user
441 authentication and initiates the selected window manager
442 or display environment
443 </para>
444 <indexterm zone="lightdm lightdm-gtk-greeter">
445 <primary sortas="b-lightdm-gtk-greeter">lightdm-gtk-greeter</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449
450 </variablelist>
451
452 </sect2>
453
454</sect1>
Note: See TracBrowser for help on using the repository browser.