source: x/dm/lightdm.xml@ c9c8e98

12.2 gimp3 ken/TL2024 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since c9c8e98 was abfacaf, checked in by Xi Ruoyao <xry111@…>, 7 months ago

Remove most references to PCRE1

Some notes:

  • proftpd has been supporting PCRE2 since 1.3.8a.
  • bluefish actually invokes PCRE via Glib, so since Glib was ported from PCRE1 to PCRE2 bluefish has been using PCRE2 in fact.
  • zsh and rasqal will support PCRE2 in the next release. For zsh pcre is not used with book instruction anyway, and for rasqal the maintainer suggests just relying on Glibc regex.h before the next release.
  • The other distros (Fedora for eg) are already disabling PCRE for slang.
  • Property mode set to 100644
File size: 15.1 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 &lfs121_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 <xref linkend="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 &qt5-deps;,
147 <ulink url="https://launchpad.net/ido">libido</ulink>, and
148 <ulink url="https://launchpad.net/libindicator">libindicator</ulink>
149
150 </para>
151
152 </sect2>
153
154 <sect2 role="installation">
155 <title>Installation of Lightdm</title>
156
157 <para>
158 First, create a dedicated user and group to take
159 control of the <command>lightdm</command> daemon after it is
160 started. Issue the following commands as the
161 <systemitem class="username">root</systemitem> user:
162 </para>
163
164<screen role="root"><userinput>groupadd -g 65 lightdm &amp;&amp;
165useradd -c "Lightdm Daemon" \
166 -d /var/lib/lightdm \
167 -u 65 -g lightdm \
168 -s /bin/false lightdm</userinput></screen>
169
170 <para revision="sysv">
171 Then change the <application>Linux-PAM</application> configuration files
172 so that <application>elogind</application> is used:
173 </para>
174
175<screen revision="sysv"><userinput>sed -i s/systemd/elogind/ data/pam/*</userinput></screen>
176
177 <para>
178 Install <application>lightdm</application> by running the following
179 commands:
180 </para>
181
182<screen><userinput>./configure --prefix=/usr \
183 --libexecdir=/usr/lib/lightdm \
184 --localstatedir=/var \
185 --sbindir=/usr/bin \
186 --sysconfdir=/etc \
187 --disable-static \
188 --disable-tests \
189 --with-greeter-user=lightdm \
190 --with-greeter-session=lightdm-gtk-greeter \
191 --docdir=/usr/share/doc/lightdm-&lightdm-version; &amp;&amp;
192make</userinput></screen>
193
194 <para>
195 This package does not come with a test suite.
196 </para>
197
198 <para>
199 Now, as the <systemitem class="username">root</systemitem> user:
200 </para>
201
202<screen role="root"><userinput>make install &amp;&amp;
203cp tests/src/lightdm-session /usr/bin &amp;&amp;
204sed -i '1 s/sh/bash --login/' /usr/bin/lightdm-session &amp;&amp;
205rm -rf /etc/init &amp;&amp;
206install -v -dm755 -o lightdm -g lightdm /var/lib/lightdm &amp;&amp;
207install -v -dm755 -o lightdm -g lightdm /var/lib/lightdm-data &amp;&amp;
208install -v -dm755 -o lightdm -g lightdm /var/cache/lightdm &amp;&amp;
209install -v -dm770 -o lightdm -g lightdm /var/log/lightdm</userinput></screen>
210
211 <para>
212 Now build the greeter:
213 </para>
214
215<screen><userinput>tar -xf ../lightdm-gtk-greeter-&lightdm-gtk-greeter-version;.tar.gz &amp;&amp;
216cd lightdm-gtk-greeter-&lightdm-gtk-greeter-version; &amp;&amp;
217
218./configure --prefix=/usr \
219 --libexecdir=/usr/lib/lightdm \
220 --sbindir=/usr/bin \
221 --sysconfdir=/etc \
222 --with-libxklavier \
223 --enable-kill-on-sigterm \
224 --disable-libido \
225 --disable-libindicator \
226 --disable-static \
227 --disable-maintainer-mode \
228 --docdir=/usr/share/doc/lightdm-gtk-greeter-&lightdm-gtk-greeter-version; &amp;&amp;
229make</userinput></screen>
230
231 <para>
232 Now, as the <systemitem class="username">root</systemitem> user:
233 </para>
234
235<screen role="root"><userinput>make install</userinput></screen>
236
237 <note>
238 <para>
239 If you installed Xorg in /opt, you will need to create a symbolic
240 link so lightdm can find the Xorg server. As the
241 <systemitem class="username">root</systemitem> user:
242 </para>
243
244 <screen role="nodump"><userinput>ln -sf /opt/xorg/bin/Xorg /usr/bin/X</userinput></screen>
245 </note>
246
247
248 </sect2>
249
250 <sect2 role="commands">
251 <title>Command Explanations</title>
252 <para>
253
254 <command>sed ... /usr/bin/lightdm-session</command>:
255 This command ensures that the initial login via the greeter sources
256 /etc/profile and ~/.bash_profile. Without this, commands that depend on
257 different environment variables may not work as expected.
258 </para>
259<!--
260 <para>
261 <parameter>ITSTOOL=/bin/true</parameter>: although
262 <xref linkend="itstool"/> is not needed in a normal build,
263 <command>configure</command> throws an error if it is not found on the
264 system. This parameter prevents the error.
265 </para>
266
267 <para>
268 <parameter>HAVE_EXO_CSOURCE=yes</parameter>: although
269 <command>exo-csource</command> is not needed in a normal build,
270 <command>configure</command> throws an error if it is not found on the
271 system. This parameter prevents the error.
272 </para>
273-->
274 </sect2>
275
276 <sect2 role="configuration">
277 <title>Configuring lightdm</title>
278
279 <sect3 id="lightdm-config">
280 <title>Config Files</title>
281
282 <para>
283 /etc/lightdm/{lightdm,users,keys,lightdm-gtk-greeter}.conf
284 </para>
285
286 <para>
287 The configuration files offer many options. If, for instance, you have
288 a multiple monitor setup but prefer the login window to be displayed on
289 only one monitor, set 'active-monitor=&lt;monitor-name&gt;' in
290 <filename>lightdm-gtk-greeter.conf</filename>. For example you could
291 use <option>active-monitor=HDMI-1</option>. You can determine the
292 monitor-names with <command>xrandr --listmonitors</command>. Note that
293 the monitor names may change if you change the graphics driver
294 and you may have to adjust the configuration accordingly.
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.