source: gnome/platform/gdm.xml@ b4cefdb6

11.2 plabs/python-mods trunk xry111/soup3
Last change on this file since b4cefdb6 was b4cefdb6, checked in by Douglas R. Reno <renodr@…>, 4 months ago

GDM: Add text on how to start GNOME from the command line.

This is useful for users who don't want a display manager, as well as
users who have the proprietary NVIDIA driver installed and want Wayland
support (since GDM won't show the session).

I placed this in the GDM page since GDM is still required for such a
session to work anyway (the .GIR files in particular), but I'm open to
moving it in the future if desired.

  • Property mode set to 100644
File size: 11.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 <!ENTITY gdm-download-http "&gnome-download-http;/gdm/&gnome-42;/gdm-&gdm-version;.tar.xz">
8 <!ENTITY gdm-download-ftp "&gnome-download-ftp;/gdm/&gnome-42;/gdm-&gdm-version;.tar.xz">
9 <!ENTITY gdm-md5sum "8fb99fd6032127fe6f57462c696607e5">
10 <!ENTITY gdm-size "792 KB">
11 <!ENTITY gdm-buildsize "32 MB">
12 <!ENTITY gdm-time "0.3 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 &lfs111_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="starting">
290 <title>Starting GNOME</title>
291
292 <para>
293 It is possible to start <application>GNOME</application> from the command
294 line, rather than using GDM. However, you must still have GDM installed
295 for some portions of the desktop to work. One reason to start from the
296 command line is if you want Wayland support on a system that has the
297 proprietary NVIDIA driver installed, since GDM will not show the Wayland
298 session type on such a system.
299 </para>
300
301 <para>
302 To start <application>GNOME</application> using
303 <xref role="nodep" linkend="xinit"/>, run the following commands:
304 </para>
305
306<screen role="nodump"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
307<literal>dbus-run-session gnome-session</literal>
308EOF
309
310startx</userinput></screen>
311
312 <para>
313 Alternatively, to start <application>GNOME</application> with Wayland
314 support, run the following command:
315 </para>
316
317<screen role="nodump"><userinput>dbus-run-session -- gnome-shell --display-server --wayland</userinput></screen>
318
319 </sect2>
320
321 <sect2 role="content">
322 <title>Contents</title>
323
324 <segmentedlist>
325 <segtitle>Installed Programs</segtitle>
326 <segtitle>Installed Libraries</segtitle>
327 <segtitle>Installed Directories</segtitle>
328
329 <seglistitem>
330 <seg>
331 gdm, gdmflexiserver, and gdm-screenshot
332 </seg>
333 <seg>
334 libgdm.so and pam_gdm.so (PAM Module)
335 </seg>
336 <seg>
337 /etc/gdm,
338 /usr/include/gdm,
339 /usr/share/gdm, and
340 /usr/share/help/*/gdm
341<!-- seems those diretories are not created at install, but at
342 runtime
343 /var/cache/gdm,
344 /var/lib/gdm,
345 /var/log/gdm, and
346 /var/run/gdm-->
347 </seg>
348 </seglistitem>
349 </segmentedlist>
350
351 <variablelist>
352 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
353 <?dbfo list-presentation="list"?>
354 <?dbhtml list-presentation="table"?>
355
356 <varlistentry id="gdm-prog">
357 <term><command>gdm</command></term>
358 <listitem>
359 <para>
360 is a login prompt for <application>GNOME</application>
361 </para>
362 <indexterm zone="gdm gdm-prog">
363 <primary sortas="b-gdm">gdm</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="gdm-screenshot">
369 <term><command>gdm-screenshot</command></term>
370 <listitem>
371 <para>
372 is a screenshot tool for <application>GDM</application>
373 </para>
374 <indexterm zone="gdm gdm-screenshot">
375 <primary sortas="b-gdm-screenshot">gdm-screenshot</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 </variablelist>
381
382 </sect2>
383
384</sect1>
Note: See TracBrowser for help on using the repository browser.