source: gnome/add/gdm.xml@ 3f909d6

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 3f909d6 was 3f909d6, checked in by Randy McMurchy <randy@…>, 15 years ago

Added new package - gnome-screensaver-2.14.2

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