source: gnome/add/gdm.xml@ b0db915

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b0db915 was b0db915, checked in by Randy McMurchy <randy@…>, 15 years ago

Updated the md5sums and build data for the GNOME add-on utilities to be compatible with GNOME-2.14.3

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6391 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 13.9 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 "&gnome-download-http;/gdm/&gnome-version;/gdm-&gdm-version;.tar.bz2">
8 <!ENTITY gdm-download-ftp "&gnome-download-ftp;/gdm/&gnome-version;/gdm-&gdm-version;.tar.bz2">
9 <!ENTITY gdm-md5sum "e880558dc3574f804f3abca869992a4f">
10 <!ENTITY gdm-size "3.0 MB">
11 <!ENTITY gdm-buildsize "54.6 MB">
12 <!ENTITY gdm-time "0.6 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 role="required"><xref linkend="libgnomecanvas"/>,
62 <xref linkend="gnome-doc-utils"/>, and
63 <xref linkend="librsvg"/></para>
64
65 <bridgehead renderas="sect4">Optional</bridgehead>
66 <para role="optional"><xref linkend="intltool"/>,
67 <xref linkend="zenity"/>,
68 <xref linkend="linux-pam"/>,
69 <xref linkend="tcpwrappers"/>, and
70 <ulink url="http://www.openafs.org/">OpenAFS</ulink></para>
71
72 <para>If you configure <application>GDM</application> to offer secure
73 connections to remote machines, you will need to have
74 <xref linkend="zenity"/>, <xref linkend="openssh"/> and
75 <xref linkend="which"/> installed.</para>
76
77 <para condition="html" role="usernotes">User Notes:
78 <ulink url="&blfs-wiki;/gdm"/></para>
79
80 </sect2>
81
82 <sect2 role="installation">
83 <title>Installation of GDM</title>
84
85 <para>It is recommended to have a dedicated user and group to take
86 control of the <command>gdm-binary</command> daemon after it is
87 started. Issue the following commands as the
88 <systemitem class="username">root</systemitem> user:</para>
89
90<screen role='root'><userinput>groupadd -g 21 gdm &amp;&amp;
91useradd -c "GDM Daemon Owner" -d /dev/null \
92 -g gdm -s /bin/bash -u 21 gdm</userinput></screen>
93
94 <para>Install <application>GDM</application> by running
95 the following commands as an unprivileged user:</para>
96
97<screen><userinput>./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
98 --sysconfdir=&gnome-etc-dir; \
99 --localstatedir=/var/lib \
100 --libexecdir=$(pkg-config \
101 --variable=prefix ORBit-2.0)/lib/gdm \
102 --mandir=$(pkg-config \
103 --variable=prefix ORBit-2.0)/share/man \
104 --with-pam-prefix=/etc &amp;&amp;
105make</userinput></screen>
106
107 <para>This package does not come with a test suite.</para>
108
109 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
110
111<screen role='root'><userinput>make install</userinput></screen>
112
113 </sect2>
114
115 <sect2 role="commands">
116 <title>Command Explanations</title>
117
118 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
119 href="../../xincludes/gnome-prefix.xml"/>
120
121 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
122 href="../../xincludes/gnome-sysconfdir.xml"/>
123
124 <para><parameter>--localstatedir=/var/lib</parameter>: This command
125 puts files in <filename class="directory">/var/lib</filename> instead of
126 <filename class="directory">$GNOME_PREFIX/var</filename>. This also has
127 the downside affect of using
128 <filename class='directory'>/var/lib/log/gdm</filename> as the log
129 directory. See the <quote>Configuration Information</quote> section below
130 for instructions on relocating the log file directory.</para>
131
132 <para><parameter>--libexecdir=$(pkg-config
133 --variable=prefix ORBit-2.0)/lib/gdm</parameter>: This parameter is
134 used so that the <application>GDM</application> internal support programs
135 are installed in the preferred location of
136 <filename class='directory'>$GNOME_PREFIX/lib/gdm</filename> instead
137 of <filename class='directory'>$GNOME_PREFIX/libexec</filename>.</para>
138
139 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
140 href="../../xincludes/gnome-mandir.xml"/>
141
142 <para><parameter>--with-pam-prefix=/etc</parameter>: This command puts
143 <application>PAM</application> configuration files in
144 <filename class="directory">/etc/pam.d</filename> instead of
145 <filename class="directory">&gnome-etc-dir;</filename>.</para>
146
147 </sect2>
148
149 <sect2 role="configuration">
150 <title>Configuring GDM</title>
151
152 <sect3 id="gdm-config">
153 <title>Config Files</title>
154
155 <para><filename>&gnome-etc-dir;/gdm/custom.conf</filename>,
156 <filename>$GNOME_PREFIX/share/gdm/defaults.conf</filename></para>
157
158 <indexterm zone="gdm gdm-config">
159 <primary sortas="e-etc-gnome-&gnome-version;&gnome-minor-version;gdm-custom.conf">
160 &gnome-etc-dir;/gdm/custom.conf</primary>
161 </indexterm>
162 <indexterm zone="gdm gdm-config">
163 <primary sortas="e-$GNOME_PREFIX-share-gdm-defaults.conf">
164 $GNOME_PREFIX/share/gdm/defaults.conf</primary>
165 </indexterm>
166
167 </sect3>
168
169 <sect3>
170 <title>Configuration Information</title>
171
172 <para>Starting with the 2.14.x version of GNOME, the default
173 configuration parameters are stored in a static file
174 (<filename><envar>$GNOME_PREFIX</envar>/share/gdm/defaults.conf</filename>).
175 This file is not intended to be edited. If modification of the
176 configuration is necessary, you should add parameters to the
177 <filename>&gnome-etc-dir;/gdm/custom.conf</filename> file. The settings
178 in this file will override the settings in the static file. The same
179 parameters in the static file are used in the configuration file.</para>
180
181 <para>Change the directory containing the <application>GDM</application>
182 log files to the <filename class='directory'>/var/log</filename>
183 hierarchy by creating a directory and modifying the
184 <filename>&gnome-etc-dir;/gdm/custom.conf</filename> configuration file. Issue
185 the following commands as the
186 <systemitem class="username">root</systemitem> user:</para>
187
188<screen role="root"><userinput>install -v -m755 -d /var/log/gdm &amp;&amp;
189sed -i.orig "/\[daemon\]/ a LogDir=/var/log/gdm" \
190 &gnome-etc-dir;/gdm/custom.conf &amp;&amp;
191rmdir -v /var/lib/log/gdm &amp;&amp;
192rmdir -v /var/lib/log</userinput></screen>
193
194 <para>The <application>GDM</application> <application>PAM</application>
195 configuration files contain modules not present in a BLFS installation.
196 If you have <application>PAM</application> installed, issue the following
197 commands as the <systemitem class="username">root</systemitem> user to
198 replace those files with files containing correctly specified
199 modules:</para>
200
201<screen role="root"><userinput>cat &gt; /etc/pam.d/gdm &lt;&lt; "EOF"
202<literal>auth required pam_unix.so
203auth required pam_nologin.so
204account required pam_unix.so
205password required pam_unix.so
206session required pam_unix.so</literal>
207
208EOF
209cat &gt; /etc/pam.d/gdm-autologin &lt;&lt; "EOF"
210<literal>auth required pam_env.so
211auth required pam_nologin.so
212auth required pam_permit.so
213account required pam_unix.so
214password required pam_unix.so
215session required pam_unix.so</literal>
216
217EOF</userinput></screen>
218
219 <indexterm zone="gdm gdm-config">
220 <primary sortas="e-etc-pam.d-gdm">/etc/pam.d/gdm</primary>
221 </indexterm>
222 <indexterm zone="gdm gdm-config">
223 <primary
224 sortas="e-etc-pam.d-gdm-autologin">/etc/pam.d/gdm-autologin</primary>
225 </indexterm>
226
227 <para id="gdm-config-dbus">If you have <application>D-BUS</application>
228 installed and you want to start the session
229 <application>D-BUS</application> daemon when you start the GNOME desktop
230 environment using <command>gdm</command>, you'll need to create a new
231 Xsession file. Create the file using the following command as the root
232 user.</para>
233
234<screen role="root"><userinput>cat &gt; $GNOME_PREFIX/share/xsessions/gnome-dbus.desktop &lt;&lt; "EOF"
235<literal>[Desktop Entry]
236Encoding=UTF-8
237Name=GNOME with D-BUS
238Comment=GNOME Desktop with D-BUS support
239Exec=dbus-launch --exit-with-session gnome-session
240TryExec=/usr/bin/dbus-launch
241Icon=
242Type=Application</literal>
243
244EOF
245chmod -v 644 $GNOME_PREFIX/share/xsessions/gnome-dbus.desktop</userinput></screen>
246
247 <para>Choose this session using the session selection dialog on the
248 display manager login screen. You also have the opportunity to make this
249 your default session.</para>
250
251 <note>
252 <para>You may use the <filename class='extension'>.desktop</filename>
253 file created above as an example to create additional
254 <filename class='extension'>.desktop</filename> files and add any other
255 desired items to the <application>GDM</application> display manager session
256 selection menu.</para>
257 </note>
258
259 <para><command>gdm</command> can be tested by executing it as the
260 <systemitem class="username">root</systemitem> user. Use the
261 <command>gdm-stop</command> command if you wish to stop the display
262 manager.</para>
263
264 </sect3>
265
266 <sect3 id="gdm-init">
267 <title>Boot Script</title>
268
269 <para>To start a graphical login when the system is booted, install the
270 <filename>/etc/rc.d/init.d/gdm</filename> init script included in the
271 <xref linkend="bootscripts"/> package. If your
272 <envar>GNOME_PREFIX</envar> environment variable is anything other than
273 <filename class='directory'>/usr</filename> or <filename
274 class='directory'>/opt/gnome-&gnome-version;&gnome-minor-version;</filename>,
275 you will need to modify the <envar>PATH</envar> statement in the script
276 to include the path where you have <application>GNOME</application>
277 installed.</para>
278
279 <indexterm zone="gdm gdm-init">
280 <primary sortas="f-gdm">gdm</primary>
281 </indexterm>
282
283<screen role="root"><userinput>make install-gdm</userinput></screen>
284
285 <para>Now edit <filename>/etc/inittab</filename> so that the line
286 containing:</para>
287
288<screen><literal>id:3:initdefault:</literal></screen>
289
290 <para>is changed to:</para>
291
292<screen><literal>id:5:initdefault:</literal></screen>
293
294 </sect3>
295
296 </sect2>
297
298 <sect2 role="content">
299 <title>Contents</title>
300
301 <segmentedlist>
302 <segtitle>Installed Programs</segtitle>
303 <segtitle>Installed Libraries</segtitle>
304 <segtitle>Installed Directories</segtitle>
305
306 <seglistitem>
307 <seg>gdm, gdm-binary, gdm-dmx-reconnect-proxy, gdm-restart,
308 gdm-safe-restart, gdm-stop, gdmXnest, gdmXnestchooser, gdmdynamic,
309 gdmflexiserver, gdmphotosetup, gdmsetup, and gdmthemetester</seg>
310 <seg>lib*mouselistener.{so,a} GTK+ modules</seg>
311 <seg>&gnome-etc-dir;/{,g}dm,
312 /var/lib/gdm,
313 /var/log/gdm and the following directories in
314 <envar>$GNOME_PREFIX</envar>/:
315 share/{,gnome/help/ ,omf/}gdm</seg>
316 </seglistitem>
317 </segmentedlist>
318
319 <variablelist>
320 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
321 <?dbfo list-presentation="list"?>
322 <?dbhtml list-presentation="table"?>
323
324 <varlistentry id="gdm-prog">
325 <term><command>gdm</command></term>
326 <listitem>
327 <para>is a wrapper script to execute the
328 <application>GDM</application> binary, the configurable
329 <application>GNOME</application> based login prompt.</para>
330 <indexterm zone="gdm gdm-prog">
331 <primary sortas="b-gdm">gdm</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="gdm-restart">
337 <term><command>gdm-restart</command></term>
338 <listitem>
339 <para>sends the HUP signal to the <application>GDM</application>
340 daemon so that it restarts. It's used after the config file
341 is edited</para>
342 <indexterm zone="gdm gdm-restart">
343 <primary sortas="b-gdm-restart">gdm-restart</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="gdm-safe-restart">
349 <term><command>gdm-safe-restart</command></term>
350 <listitem>
351 <para>sends the USR1 signal to the <application>GDM</application>
352 daemon so that it restarts. It's used after the config file
353 is edited.</para>
354 <indexterm zone="gdm gdm-safe-restart">
355 <primary sortas="b-gdm-safe-restart">gdm-safe-restart</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="gdmsetup">
361 <term><command>gdmsetup</command></term>
362 <listitem>
363 <para>is a graphical interface to edit the
364 <filename>gdm.conf</filename> file.</para>
365 <indexterm zone="gdm gdmsetup">
366 <primary sortas="b-gdmsetup">gdmsetup</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370 </variablelist>
371
372 </sect2>
373
374</sect1>
Note: See TracBrowser for help on using the repository browser.