source: gnome/platform/gdm.xml@ 6c6b4190

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 6c6b4190 was 6c6b4190, checked in by Pierre Labastie <pierre.labastie@…>, 6 months ago

Fix xwayland and gdm for non xorg GNOME on sysv

  • create the /tmp/.X11-unix directory with permission 1777 using /etc/sysconfig/createfiles
  • add pam_loginuid.so as required in /etc/pam.d/gdm-launch-environment
  • ensure /etc/X11/xorg.conf.d exists after installing xwayland (both sysv and systemd)
  • Property mode set to 100644
File size: 10.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 <!ENTITY gdm-download-http "&gnome-download-http;/gdm/&gnome-40;/gdm-&gdm-version;.tar.xz">
8 <!ENTITY gdm-download-ftp "&gnome-download-ftp;/gdm/&gnome-40;/gdm-&gdm-version;.tar.xz">
9 <!ENTITY gdm-md5sum "fa32fee88d242ebf5d1c2fb69e74457e">
10 <!ENTITY gdm-size "788 KB">
11 <!ENTITY gdm-buildsize "36 MB">
12 <!ENTITY gdm-time "0.1 SBU">
13]>
14
15<sect1 id="gdm" xreflabel="GDM-&gdm-version;">
16 <?dbhtml filename="gdm.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>GDM-&gdm-version;</title>
23
24 <indexterm zone="gdm">
25 <primary sortas="a-GDM">GDM</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to GDM</title>
30
31 <para>
32 <application>GDM</application> is a system service that is
33 responsible for providing graphical logins and managing local
34 and remote displays.
35 </para>
36
37 &lfs110a_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&gdm-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&gdm-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &gdm-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &gdm-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &gdm-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &gdm-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72 <!--
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Required patch:
78 <ulink url="&patch-root;/gdm-&gdm-version;-security_fix-1.patch"/>
79 </para>
80 </listitem>
81 </itemizedlist>
82 -->
83 <bridgehead renderas="sect3">GDM Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="accountsservice"/>,
88 <xref linkend="gtk3"/>,
89 <xref linkend="iso-codes"/>,
90 <xref linkend="itstool"/>,
91 <xref linkend="libcanberra"/>,
92 <xref linkend="libdaemon"/>, and
93 <xref linkend="linux-pam"/>
94 </para>
95
96 <bridgehead renderas="sect4">Optional</bridgehead>
97 <para role="optional">
98 <xref linkend="keyutils"/>
99 </para>
100
101 <bridgehead renderas="sect4">Runtime Dependencies</bridgehead>
102 <para role="required">
103 <xref role="runtime" linkend="gnome-session"/>,
104 <xref role="runtime" linkend="gnome-shell"/>, and
105 <phrase revision="sysv"><xref role="runtime" linkend="elogind"/></phrase>
106 <phrase revision="systemd"><xref role="runtime" linkend="systemd"/></phrase>
107 </para>
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/gdm"/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of GDM</title>
116
117 <para>
118 It is recommended to have a dedicated user and group to take
119 control of the <command>gdm</command> daemon after it is
120 started. Issue the following commands as the
121 <systemitem class="username">root</systemitem> user:
122 </para>
123
124<screen role="root"><userinput>groupadd -g 21 gdm &amp;&amp;
125useradd -c "GDM Daemon Owner" -d /var/lib/gdm -u 21 \
126 -g gdm -s /bin/false gdm &amp;&amp;
127passwd -ql gdm</userinput></screen>
128
129 <para revision="sysv">
130 First, adapt GDM to build without systemd present:
131 </para>
132
133<screen revision="sysv"><userinput remap="pre">sed -i -r '/(^| )systemd_dep/d' meson.build</userinput></screen>
134
135 <para>
136 Install <application>GDM</application> by running the following
137 commands:
138 </para>
139
140<screen revision="sysv"><userinput>sed -e 's@systemd@elogind@' \
141 -e '/elogind/isession required pam_loginuid.so' \
142 -i data/pam-lfs/gdm-launch-environment.pam &amp;&amp;
143
144mkdir build &amp;&amp;
145cd build &amp;&amp;
146
147meson --prefix=/usr \
148 --buildtype=release \
149 -Dgdm-xsession=true \
150 -Dsystemd-journal=false \
151 -Dsystemdsystemunitdir=/tmp \
152 -Dsystemduserunitdir=/tmp .. &amp;&amp;
153ninja</userinput></screen>
154
155<screen revision="systemd"><userinput>mkdir build &amp;&amp;
156cd build &amp;&amp;
157
158meson --prefix=/usr \
159 --buildtype=release \
160 -Dgdm-xsession=true .. &amp;&amp;
161ninja</userinput></screen>
162
163 <para>
164 This package does not come with a usable test suite.
165 </para>
166
167 <para>
168 Now, as the <systemitem class="username">root</systemitem> user:
169 </para>
170
171<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
172rm -rv /tmp/*.{service,target.d}</userinput></screen>
173
174<screen role="root" revision="systemd"><userinput>ninja install</userinput></screen>
175
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
182 href="../../xincludes/meson-buildtype-release.xml"/>
183
184 <para>
185 <option>-Dinitial-vt=7</option>: Use this switch
186 to make <application>GDM</application> start on VT7
187 instead of the first free VT.
188 </para>
189
190 <para>
191 <option>-Ddefault-pam-config=lfs</option>: Use this
192 switch if you did not create the
193 <filename>/etc/lfs-release</filename> file or distribution
194 auto detection will fail and you will be unable to use
195 <application>GDM</application>.
196 </para>
197
198 <para>
199 <parameter>-Dgdm-xsession=true</parameter>: This enables the
200 installation of the <application>GDM</application> Xsession file.
201 </para>
202
203 </sect2>
204
205 <sect2 role="configuration">
206 <title>Configuring GDM</title>
207
208 <sect3 id="gdm-config">
209 <title>Config Files</title>
210
211 <para>
212 <filename>/etc/gdm/custom.conf</filename>
213 </para>
214
215 <indexterm zone="gdm gdm-config">
216 <primary sortas="e-etc-gdm-custom.conf">/etc/gdm/custom.conf</primary>
217 </indexterm>
218
219 </sect3>
220
221 <sect3>
222 <title>Configuration Information</title>
223
224 <para>
225 The GDM daemon is configured using the
226 <filename>/etc/gdm/custom.conf</filename> file. Default values
227 are stored in GSettings in the <filename>gdm.schemas</filename>
228 file. It is recommended that end-users modify the
229 <filename>/etc/gdm/custom.conf</filename> file because the schemas
230 file may be overwritten when the user updates their system to have
231 a newer version of <application>GDM</application>.
232 </para>
233
234 </sect3>
235
236 <sect3 id="gdm-init">
237 <title><phrase revision="sysv">Boot Script</phrase>
238 <phrase revision="systemd">Systemd Unit</phrase></title>
239
240 <indexterm zone="gdm gdm-init">
241 <primary sortas="f-gdm">gdm</primary>
242 </indexterm>
243
244 <para revision="sysv">
245 To start <command>gdm</command> automatically when the system is
246 switched to runlevel 5, install the
247 <filename>/etc/rc.d/init.d/xdm</filename> script and the
248 <filename>/etc/sysconfig/xdm</filename> configuration file
249 included in the <xref linkend="bootscripts"/> package
250 and adjust <filename>/etc/inittab</filename> by running
251 as the <systemitem class="username">root</systemitem> user:
252 </para>
253
254<screen role="root" revision="sysv"><userinput>make install-gdm</userinput></screen>
255
256 <para revision="sysv">
257 In order to permanently set the default runlevel to 5, starting the
258 <command>gdm</command> greeter screen automatically, you can modify
259 <filename>/etc/inittab</filename>. As the <systemitem
260 class="username">root</systemitem> user:
261 </para>
262
263<screen role="root" revision="sysv"><userinput>sed /initdefault/s/3/5/ -i /etc/inittab</userinput></screen>
264
265 <para revision="systemd">
266 To start the <command>gdm</command> daemon at boot, enable
267 the previously installed systemd unit by running the following command
268 as the <systemitem class="username">root</systemitem> user:
269 </para>
270
271<screen role="root" revision="systemd"><userinput>systemctl enable gdm</userinput></screen>
272
273<!-- [pierre October 2020] I don't understand why this is here: power
274 management works perfectly well
275 <para revision="sysv">
276 You should also disable default elogind power management:
277 </para>
278
279<screen role="root" revision="sysv"><userinput>cat &gt;&gt; /etc/elogind/logind.conf &lt;&lt; "EOF"
280<literal>AllowSuspend=no
281AllowHibernation=no</literal>
282EOF</userinput></screen>
283-->
284
285 </sect3>
286
287 </sect2>
288
289 <sect2 role="content">
290 <title>Contents</title>
291
292 <segmentedlist>
293 <segtitle>Installed Programs</segtitle>
294 <segtitle>Installed Libraries</segtitle>
295 <segtitle>Installed Directories</segtitle>
296
297 <seglistitem>
298 <seg>
299 gdm, gdmflexiserver, and gdm-screenshot
300 </seg>
301 <seg>
302 libgdm.so and pam_gdm.so (PAM Module)
303 </seg>
304 <seg>
305 /etc/gdm,
306 /usr/include/gdm,
307 /usr/share/gdm,
308 /usr/share/help/*/gdm,
309 /var/cache/gdm,
310 /var/lib/gdm,
311 /var/log/gdm, and
312 /var/run/gdm
313 </seg>
314 </seglistitem>
315 </segmentedlist>
316
317 <variablelist>
318 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
319 <?dbfo list-presentation="list"?>
320 <?dbhtml list-presentation="table"?>
321
322 <varlistentry id="gdm-prog">
323 <term><command>gdm</command></term>
324 <listitem>
325 <para>
326 is a login prompt for <application>GNOME</application>
327 </para>
328 <indexterm zone="gdm gdm-prog">
329 <primary sortas="b-gdm">gdm</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="gdm-screenshot">
335 <term><command>gdm-screenshot</command></term>
336 <listitem>
337 <para>
338 is a screenshot tool for <application>GDM</application>
339 </para>
340 <indexterm zone="gdm gdm-screenshot">
341 <primary sortas="b-gdm-screenshot">gdm-screenshot</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 </variablelist>
347
348 </sect2>
349
350</sect1>
Note: See TracBrowser for help on using the repository browser.