source: x/dm/lightdm.xml@ 9538254f

trunk
Last change on this file since 9538254f was 0e16b36, checked in by Bruce Dubbs <bdubbs@…>, 3 weeks ago

Archive qt5.

There are a large number of packages that needed to be changed to
remove qt5, but most are harmless. One package that is affected
is vlc where the gui interface is no longer available. Videos
can still be played from the command line and the kf6 dependency
on vlc is still satisfied.

If necessary qt5 can be restored for vlc.

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