source: gnome/add/gdm.xml@ 45698ce

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 45698ce was 45698ce, checked in by Randy McMurchy <randy@…>, 19 years ago

Updated to GDM-2.8.0.5

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5220 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gdm-download-http "http://ftp.gnome.org/pub/GNOME/sources/gdm/2.8/gdm-&gdm-version;.tar.bz2">
8 <!ENTITY gdm-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/gdm/2.8/gdm-&gdm-version;.tar.bz2">
9 <!ENTITY gdm-md5sum "2944ba9c2a2bf7032ac81dc24eecf32d">
10 <!ENTITY gdm-size "2.7 MB">
11 <!ENTITY gdm-buildsize "51.7 MB">
12 <!ENTITY gdm-time "0.7 SBU">
13]>
14
15<sect1 id="gdm" xreflabel="GDM-&gdm-version;">
16 <?dbhtml filename="gdm.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>GDM-&gdm-version;</title>
24
25 <indexterm zone="gdm">
26 <primary sortas="a-GDM">GDM</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GDM</title>
31
32 <para>The <application>GDM</application> package contains
33 <application>GNOME</application>'s Display Manager daemon. This is
34 useful for allowing configurable graphical logins.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&gdm-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&gdm-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &gdm-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &gdm-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &gdm-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &gdm-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">GDM Dependencies</bridgehead>
59
60 <bridgehead renderas="sect4">Required</bridgehead>
61 <para><xref linkend="libgnomeui"/>,
62 <xref linkend="scrollkeeper"/> and
63 <xref linkend="librsvg"/></para>
64
65 <bridgehead renderas="sect4">Optional</bridgehead>
66 <para><xref linkend="Linux_PAM"/> and
67 <xref linkend="tcpwrappers"/></para>
68
69 </sect2>
70
71 <sect2 role="installation">
72 <title>Installation of GDM</title>
73
74 <para>It is recommended to have a dedicated user and group to take
75 control of the <command>gdm-binary</command> daemon after it is
76 started. Issue the following commands as the
77 <systemitem class="username">root</systemitem> user:</para>
78
79<screen role='root'><userinput>groupadd -g 21 gdm &amp;&amp;
80useradd -c "GDM Daemon Owner" -d /dev/null \
81 -g gdm -s /bin/bash -u 21 gdm</userinput></screen>
82
83 <para>Install <application>GDM</application> by running
84 the following commands as an unprivileged user:</para>
85
86<screen><userinput>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
87 --libexecdir=`pkg-config --variable=prefix ORBit-2.0`/sbin \
88 --sysconfdir=/etc/gnome --localstatedir=/var/lib \
89 --with-pam-prefix=/etc &amp;&amp;
90make</userinput></screen>
91
92 <para>This package does not come with a test suite.</para>
93
94 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
95
96<screen role='root'><userinput>make install &amp;&amp;
97chmod -v 644 `pkg-config --variable=prefix ORBit-2.0`\
98/share/gdm/BuiltInSessions/default.desktop \
99 `pkg-config --variable=prefix ORBit-2.0`\
100/share/xsessions/gnome.desktop</userinput></screen>
101
102 </sect2>
103
104 <sect2 role="commands">
105 <title>Command Explanations</title>
106
107 <para><parameter>--sysconfdir=/etc/gnome</parameter>: This command puts
108 configuration files in <filename class="directory">/etc/gnome</filename>
109 instead of <filename class="directory">$GNOME_PREFIX/etc</filename>.</para>
110
111 <para><parameter>--localstatedir=/var/lib</parameter>: This command
112 puts files in <filename class="directory">/var/lib</filename> instead of
113 <filename class="directory">$GNOME_PREFIX/var</filename>. This also has
114 the downside affect of using
115 <filename class='directory'>/var/lib/log/gdm</filename> as the log
116 directory. See the <quote>Configuration Information</quote> section below
117 for information how to relocate the log file directory.</para>
118
119 <para><parameter>--with-pam-prefix=/etc</parameter>: This command puts
120 <application>PAM</application> configuration files in
121 <filename class="directory">/etc/pam.d</filename> instead of
122 <filename class="directory">/etc/gnome</filename>.</para>
123
124 </sect2>
125
126 <sect2 role="configuration">
127 <title>Configuring GDM</title>
128
129 <sect3 id="gdm-config">
130 <title>Config Files</title>
131
132 <para><filename>/etc/gnome/gdm/gdm.conf</filename></para>
133
134 <indexterm zone="gdm gdm-config">
135 <primary sortas="e-etc-gnome-gdm-gdm.conf">/etc/gnome/gdm/gdm.conf</primary>
136 </indexterm>
137
138 </sect3>
139
140 <sect3>
141 <title>Configuration Information</title>
142
143 <para>If desired, change the directory containing the
144 <application>GDM</application> log files to the
145 <filename class='directory'>/var/log</filename> hierarchy by modifying
146 the <filename>/etc/gnome/gdm/gdm.conf</filename> configuration file as
147 the <systemitem class="username">root</systemitem> user:</para>
148
149<screen role="root"><userinput>sed -i "s|var/lib/log|var/log|" /etc/gnome/gdm/gdm.conf</userinput></screen>
150
151 <para>The <application>GDM</application> <application>PAM</application>
152 config files contain modules not present in a BLFS installation. The
153 following commands will replace those files (issue as the
154 <systemitem class="username">root</systemitem> user):</para>
155
156<screen role="root"><userinput>cat &gt; /etc/pam.d/gdm &lt;&lt; "EOF"
157<literal>auth required pam_unix.so
158auth required pam_unix.so
159auth required pam_nologin.so
160account required pam_unix.so
161password required pam_unix.so
162session required pam_unix.so</literal>
163
164EOF
165cat &gt; /etc/pam.d/gdm-autologin &lt;&lt; "EOF"
166<literal>auth required pam_env.so
167auth required pam_env.so
168auth required pam_nologin.so
169auth required pam_permit.so
170account required pam_unix.so
171password required pam_unix.so
172session required pam_unix.so</literal>
173
174EOF</userinput></screen>
175
176 <indexterm zone="gdm gdm-config">
177 <primary sortas="e-etc-pam.d-gdm">/etc/pam.d/gdm</primary>
178 </indexterm>
179
180 <indexterm zone="gdm gdm-config">
181 <primary
182 sortas="e-etc-pam.d-gdm-autologin">/etc/pam.d/gdm-autologin</primary>
183 </indexterm>
184
185 <para><command>gdm</command> can be tested by executing it from a
186 <systemitem class="username">root</systemitem> console.</para>
187
188 </sect3>
189
190 <sect3 id="gdm-init">
191 <title>Boot Script</title>
192
193 <para>To start a graphical login at boot, install the
194 <filename>/etc/rc.d/init.d/gdm</filename> init script included in the
195 <xref linkend="intro-important-bootscripts"/> package. If your
196 <envar>GNOME_PREFIX</envar> environment variable is anything other than
197 <filename class='directory'>/usr</filename> or
198 <filename class='directory'>/opt/gnome-2.10</filename>, you will need to
199 modify the <envar>PATH</envar> statement in the script to include the
200 path where you have <application>GNOME</application> installed.</para>
201
202 <indexterm zone="gdm gdm-init">
203 <primary sortas="f-gdm">gdm</primary>
204 </indexterm>
205
206<screen role="root"><userinput>make install-gdm</userinput></screen>
207
208 <para>To autostart with a graphical login, edit
209 <filename>/etc/inittab</filename> so that the line containing:</para>
210
211<screen><literal>id:3:initdefault:</literal></screen>
212
213 <para>is changed to:</para>
214
215<screen><literal>id:5:initdefault:</literal></screen>
216
217 </sect3>
218
219 </sect2>
220
221 <sect2 role="content">
222 <title>Contents</title>
223
224 <segmentedlist>
225 <segtitle>Installed Programs</segtitle>
226 <segtitle>Installed Libraries</segtitle>
227 <segtitle>Installed Directories</segtitle>
228
229 <seglistitem>
230 <seg>gdm, gdm-binary, gdmXnest, gdmXnestchooser, gdmchooser,
231 gdmflexiserver, gdmgreeter, gdmlogin, gdmphotosetup, gdmsetup,
232 gdmthemetester, gdm-restart, gdm-safe-restart, gdm-stop,
233 gdmconfig, gdmopen, and gdmtranslate</seg>
234 <seg>None</seg>
235 <seg>/etc/gnome/dm, /etc/gnome/gdm,
236 $GNOME_PREFIX/share/gdm,
237 $GNOME_PREFIX/share/gnome/capplets,
238 $GNOME_PREFIX/share/gnome/help/gdm,
239 $GNOME_PREFIX/share/omf/gdm,
240 $GNOME_PREFIX/share/xsessions,
241 /var/lib/gdm and /var/log/gdm</seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="gdm-prog">
251 <term><command>gdm</command></term>
252 <listitem>
253 <para>is a wrapper script to execute the
254 <application>GDM</application> binary, the configurable
255 <application>GNOME</application> based login prompt.</para>
256 <indexterm zone="gdm gdm-prog">
257 <primary sortas="b-gdm">gdm</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="gdmchooser">
263 <term><command>gdmchooser</command></term>
264 <listitem>
265 <para>is an application for selecting XDMCP enabled hosts on
266 the local network.</para>
267 <indexterm zone="gdm gdmchooser">
268 <primary sortas="b-gdmchooser">gdmchooser</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="gdmsetup">
274 <term><command>gdmsetup</command></term>
275 <listitem>
276 <para>is a graphical interface to edit the
277 <filename>gdm.conf</filename> file.</para>
278 <indexterm zone="gdm gdmsetup">
279 <primary sortas="b-gdmsetup">gdmsetup</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="gdm-restart">
285 <term><command>gdm-restart</command></term>
286 <listitem>
287 <para>sends the HUP signal to the <application>GDM</application>
288 daemon so that it restarts. It's used after the config file
289 is edited</para>
290 <indexterm zone="gdm gdm-restart">
291 <primary sortas="b-gdm-restart">gdm-restart</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="gdm-safe-restart">
297 <term><command>gdm-safe-restart</command></term>
298 <listitem>
299 <para>sends the USR1 signal to the <application>GDM</application>
300 daemon so that it restarts. It's used after the config file
301 is edited.</para>
302 <indexterm zone="gdm gdm-safe-restart">
303 <primary sortas="b-gdm-safe-restart">gdm-safe-restart</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="gdmconfig">
309 <term><command>gdmconfig</command></term>
310 <listitem>
311 <para>is an application for managing the configuration of the
312 entire <application>GDM</application> applications suite. It
313 handles look and feel, security, XDMCP, GDMchooser and more.</para>
314 <indexterm zone="gdm gdmconfig">
315 <primary sortas="b-gdmconfig">gdmconfig</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 </variablelist>
321
322 </sect2>
323
324</sect1>
Note: See TracBrowser for help on using the repository browser.