summaryrefslogtreecommitdiff
path: root/docs/gdmconfig/C/gdmconfig.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/gdmconfig/C/gdmconfig.sgml')
-rw-r--r--docs/gdmconfig/C/gdmconfig.sgml1431
1 files changed, 0 insertions, 1431 deletions
diff --git a/docs/gdmconfig/C/gdmconfig.sgml b/docs/gdmconfig/C/gdmconfig.sgml
deleted file mode 100644
index 6e9bdd1b..00000000
--- a/docs/gdmconfig/C/gdmconfig.sgml
+++ /dev/null
@@ -1,1431 +0,0 @@
-<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
- <!-- if not using PNG graphic, replace reference above with
- .....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
- .....PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
- -->
-<!ENTITY version "2.0.97.1">
-]>
-
-<!--
- (Do not remove this comment block.)
- Maintained by the GNOME Documentation Project
- http://developer.gnome.org/projects/gdp
- Template version: 1.0.3
- Template last modified: Nov 16, 2000
--->
-
-<article id="index">
- <artheader>
- <title>Gdmconfig Manual</title>
- <copyright>
- <year>2001</year>
- <holder>Trevor Curtis</holder>
- </copyright>
-
- <!-- translators: uncomment this:
-
- <copyright>
- <year>2000</year>
- <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
- </copyright>
-
- -->
- <!-- Use this legal notice for online documents which depend on -->
- <!-- core GNOME packages. -->
- <legalnotice id="legalnotice">
- <para>
- Permission is granted to copy, distribute and/or modify this document
- under the terms of the <ulink type="help"
- url="gnome-help:fdl"><citetitle>GNU Free Documentation
- License</citetitle></ulink>, Version 1.1 or any later version
- published by the Free Software Foundation with no Invariant Sections,
- no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
- can be found <ulink type="help" url="gnome-help:fdl">here</ulink>.
- </para>
- <para>
- Many of the names used by companies to distinguish their products and
- services are claimed as trademarks. Where those names appear in any
- GNOME documentation, and those trademarks are made aware to the members
- of the GNOME Documentation Project, the names have been printed in caps
- or initial caps.
- </para>
- </legalnotice>
-
- <!-- Use this legal notice for documents which are placed on -->
- <!-- the web, shipped in any way other than online documents -->
- <!-- (eg. PS, PDF, or RTF), or which do not depend on the -->
- <!-- core GNOME distribution. -->
- <!-- -->
- <!-- If you use this version, you must place the following -->
- <!-- line in the document declaration at the top of your -->
- <!-- document: -->
- <!-- <!ENTITY FDL SYSTEM "fdl.sgml"> -->
- <!-- and the following line at the bottom of your document -->
- <!-- after the last </sect1>. -->
- <!-- &FDL; -->
- <!--
-
-
- <legalnotice id="legalnotice">
- <para>
- Permission is granted to copy, distribute and/or modify this document
- under the terms of the <link linkend="fdl"><citetitle>GNU
- Free Documentation License</citetitle></link>, Version 1.1 or any later
- version published by the Free Software Foundation with no Invariant
- Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the
- license can be found in <xref linkend="fdl">.
- </para>
- <para>
- Many of the names used by companies to distinguish their products and
- services are claimed as trademarks. Where those names appear in any
- GNOME documentation, and those trademarks are made aware to the members
- of the GNOME Documentation Project, the names have been printed in caps
- or initial caps.
- </para>
- </legalnotice>
- -->
-
- <releaseinfo>
- This is version 1.0 of manual.
- </releaseinfo>
-
-</artheader>
-
-<sect1 id="intro">
- <title>Introduction</title>
-
- <para>
- <application>GDM Configurator, (GNOME Display Manager
- Configurator)</application> is a configuration application
- for the GDM (Gnome Display Manager). Typically, when running your
- system in a
- graphical login mode, the GDM is the application that facilites
- logins. <application>GDM Configurator</application> allows for easy
- configuration of the GDM at various levels of detail.
- Customizations affect both operations and appearances.
- </para>
-
- <para>
- To run <application>GDM Configurator</application>, select
- <menuchoice><guisubmenu>System</guisubmenu>
- <guimenuitem>GDM Configurator</guimenuitem>
- </menuchoice>
- from the <guimenu>Main Menu</guimenu>, or type
- <command>gdmconfig</command> on the command line.
- </para>
-
- <note><title>Root access required</title>
- <para><application>GDM Configurator</application> requires root access to
- run.
- </para>
- </note>
-
- <para>
- <application>GDM Configurator</application> is included in the
- <filename>Gnome-Core</filename> package, which is part of the
- GNOME desktop environment. This document describes version
- &version; of <application>GDM Configurator</application>.
- </para>
-</sect1>
-
-<sect1 id="usage">
- <title>Using Gnome Display Manager Configurator</title>
- <para>
- <application>GDM Configurator</application> can be used to
- change the login apperance, and behaviour as well as
- security and environment options of the GDM to varying
- degrees of detail. This section describes basic usage of
- <application>GDM Configurator</application>.
- </para>
-
- <sect2 id="mainwin">
- <title>Basic usage</title>
- <para>
- Starting <application>GDM Configure</application> opens the
- <interface>Main window</interface>, shown in <xref
- linkend="mainwindow-fig">. This window contains all
- options relating to the GDM's configuration.
- </para>
-
- <figure id="mainwindow-fig">
- <title>GDM Configurator Main Window</title>
- <screenshot>
- <screeninfo>GDM Configurator Main Window</screeninfo>
- <graphic fileref="figures/GDM_full.png" format="png" srccredit="Trevor
- Curtis">
- </graphic>
- </screenshot>
- </figure>
- </sect2>
-
- <sect2 id="menubar">
- <title>Toolbar</title>
- <para>
- Toolbar Menus
- </para>
-
- <figure id="menu-fig">
- <title>The login appearance tab</title>
- <screenshot>
- <screeninfo>The login appearance tab</screeninfo>
- <graphic fileref="figures/GDM_menubar" format="png" srccredit="Trevor
- Curtis">
- </graphic>
- </screenshot>
- </figure>
-
- <variablelist><title><guimenu>Configuration
- </guimenu></title>
- <varlistentry>
- <term><guimenuitem>Revert settings</guimenuitem></term>
- <listitem>
- <para>
- Reset current changes to initial settings
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Apply</guimenuitem></term>
- <listitem>
- <para>
- Apply current changes
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <para>
- <variablelist><title><guimenu>Help</guimenu></title>
- <varlistentry>
- <term><guimenuitem>GDM
- Configurator
- users guide</guimenuitem>
- </term>
- <listitem>
- <para>How to get this document from within <application>GDM
- Configurator</application>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>About...</guimenuitem></term>
- <listitem>
- <para>A little bit of kudos for all of the very hard
- working guys/gals who made it all possible
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect2>
-
- <sect2 id="options">
- <title>Options</title>
- <para>
- The <guilabel>Options</guilabel> box in the upper left hand
- corner controls the level of detail and customization
- offered on the tabs to its right. Below the Options box
- is a brief description of the level chosen, and what can be
- done in that level. The levels are explained below.
- </para>
-
- <para>
- <variablelist>
- <varlistentry>
- <term><guilabel>Basic</guilabel></term>
- <listitem>
- <para>
- This exposes the <guilabel>Login
- appearance</guilabel>, <guilabel>Login
- behaviour</guilabel>, and <guilabel>Face
- browser</guilabel> tabs to the right
- of the <guilabel>Options</guilabel> box.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Expert</guilabel></term>
- <listitem>
- <para>
- This exposes the <guilabel>Security</guilabel>,
- <guilabel>XDMCP</guilabel>, and <guilabel>X-server
- setup</guilabel> tabs to the right
- of the <guilabel>Options</guilabel> box.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>System</guilabel></term>
- <listitem>
- <para>
- This exposes the <guilabel>Paths</guilabel>,
- <guilabel>Environment</guilabel>, and <guilabel>
- Chooser</guilabel> tabs to the right
- of the <guilabel>Options</guilabel> box.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
-
- <caution>
- <title>Expert option and security</title>
- <para>
- Enabling the expert option, allows for changes in GDM's
- security to be made. Improper configuration may lead to
- vulnerabilities for attackers.
- </para>
- </caution>
- <warning>
- <title>System option and system health</title>
- <para>
- Enabling the system option, allows for very specific changes
- which can impact the operation of your system. This option
- is only recommended for those who know exactly what they
- are doing.
- </para>
- </warning>
- </sect2>
-</sect1>
-
-
-<sect1 id="basic">
- <title>The Basic Options</title>
- <para>
- Below are the options for the <guilabel>Login
- appearance</guilabel>, <guilabel>Login behaviour</guilabel>
- ,<guilabel>Face browser</guilabel>, and <guilabel> Automatic
- login</guilabel> tabs.
- </para>
- <variablelist><title><guilabel>Login appearance</guilabel></title>
- <varlistentry>
- <term></term>
- <listitem>
- <figure id="loginappearance-fig">
- <title>The login appearance tab</title>
- <screenshot>
- <screeninfo>The login appearance tab</screeninfo>
- <graphic fileref="figures/GDM_login_appear" format="png" srccredit="Trevor
- Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><guibutton>Minimised Icon:</guibutton></term>
- <listitem>
- <para>
- Change the icon that represents the login screen
- when minimized.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Logo</guilabel></term>
- <listitem>
- <para>
- Change the image that is displayed in the login
- window
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Gtk+ RC file</guilabel></term>
- <listitem>
- <para>
- Specify the location of <filename>.gtkrc</filename>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title><guilabel>Login behaviour</guilabel></title>
- <varlistentry>
- <term></term>
- <listitem>
- <figure id="loginbehaviour-fig">
- <title>The login behaviour tab</title>
- <screenshot>
- <screeninfo>The login behaviour tab</screeninfo>
- <graphic fileref="figures/GDM_login_behav"
- format="png" srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guibutton>Quiver on failure</guibutton></term>
- <listitem>
- <para>
- If login fails, make the login window shake.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Exclude these users</guilabel></term>
- <listitem>
- <para>
- Do not show the users in the user menu, on the login box.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guibutton>Default font:</guibutton></term>
- <listitem>
- <para>
- The font to display and default to.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Welcome message</guilabel></term>
- <listitem>
- <para>
- The text message to display in the login screen.
- </para>
- <note><title>Display machine name</title>
- <para>To have GDM display your machine name you can
- type &percnt;n in the <guilabel>Welcome message</guilabel>
- field, and it will
- always be replaced with whatever your machine's name
- is.
- </para>
- </note>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Background Program</guilabel></term>
- <listitem>
- <para>This allows you to run a given script, or
- application in the background whilst the login prompt
- is displayed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Default locale</guilabel></term>
- <listitem>
- <para>The locale that should be set as default in the
- GDM
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guibutton>Lock position</guibutton></term>
- <listitem>
- <para>Lock the login box, such that it cannot be moved
- within the login screen.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guibutton>Manually set
- position</guibutton></term>
- <listitem>
- <para>Allow for the login box to be moved manually
- within the login screen
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>X position</guilabel></term>
- <listitem>
- <para>The x coordinate for the login box placement
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Y position</guilabel></term>
- <listitem>
- <para>The y coordinate for the login box placement
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Xinerama screen</guilabel></term>
- <listitem>
- <para>This option allows one to specify on which monitor,
- in a multi-monitor setup, the GDM login screen will be
- displayed.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title><guilabel>Face browser</guilabel>
- </title>
- <varlistentry>
- <term></term>
- <listitem>
- <figure id="facebrowser-fig">
- <title>The face browser tab</title>
- <screenshot>
- <screeninfo>The face browser tab</screeninfo>
- <graphic fileref="figures/GDM_face_brow" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Show choosable user images</term>
- <listitem>
- <para>Customization of user images in the face
- browser
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Default face image</guilabel></term>
- <listitem>
- <para>Change the image used for default users in the
- face browser
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Global faces
- directory</guilabel></term>
- <listitem>
- <para>The directory where the face images reside
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Maximum face width</guilabel></term>
- <listitem>
- <para>The maximum width any given face image may be
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Maximum face height</guilabel></term>
- <listitem>
- <para>The maximum height any given face image may be
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title><guimenu>Background</guimenu></title>
- <varlistentry><term></term><listitem>
- <figure id="background-fig">
- <title>The background tab</title>
- <screenshot>
- <screeninfo>The background tab</screeninfo>
- <graphic fileref="figures/GDM_background" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Background type</guimenuitem></term>
- <listitem>
- <para>
- Selection of background type. Options are backgrounds by
- colour, image, or none at all.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Scale background image to fit</guilabel></term>
- <listitem>
- <para>
- Allow an image, if selected above, to be scaled to fit alloted
- space.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Only color on remote displays</guilabel></term>
- <listitem>
- <para>
- Enable a colour to be displayed only on remote systems
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Background program</guilabel></term>
- <listitem>
- <para>
- Allow a program to be run in the background
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title><guimenu>Automatic login</guimenu></title>
- <varlistentry><term></term>
- <listitem>
- <figure id="autologin-fig">
- <title>The automatic login tab</title>
- <screenshot>
- <screeninfo>The automatic login tab</screeninfo>
- <graphic fileref="figures/GDM_auto_login" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Login a user automatically on first bootup
- </guimenuitem></term>
- <listitem>
- <para>
- Enable logging in as the specified user when first starting
- the system.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Login a user automatically after a specified
- number of seconds.</guimenuitem></term>
- <listitem>
- <para>
- Allow the GDM to automatically login after the specified number of seconds using the specified user name.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Timed login</guimenuitem></term>
- <listitem>
- <para>
- The specified user to be used to login automaticaly.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Seconds before login</guimenuitem></term>
- <listitem>
- <para>
- The specified number of seconds before the GDM automatically
- logs in.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-</sect1>
-
-<sect1 id="expert">
- <title>The Expert Options</title>
- <para>
- Below are the options for the <guilabel>Security
- </guilabel>, <guilabel>XDMCP</guilabel>,
- <guilabel>X-server setup</guilabel>, <guilabel>Login sessions</guilabel>,
- and <guilabel>Miscellaneous</guilabel> tabs.
- </para>
- <variablelist><title><guimenu>Security</guimenu></title>
- <varlistentry><term></term>
- <listitem>
- <figure id="security-fig">
- <title>The security tab</title>
- <screenshot>
- <screeninfo>The security tab</screeninfo>
- <graphic fileref="figures/GDM_security" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Allow root to login with GDM
- </guimenuitem></term>
- <listitem>
- <para>
- Allow priviledged users, such as root, to login via
- the GDM.
- <note>
- <title>PAM supported systems</title>
- <para>On systems that support PAM, this option is
- ignored, and it becomes the responsiblity of the PAM
- libraries to determine whether the user will be on the
- local display or not.
- </para>
- </note>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Kill 'init'
- clients</guimenuitem></term>
- <listitem>
- <para>
- Allow the GDM to kill X clients that start from
- initialization scripts when a user logs in.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Authentication errors should be
- verbose</guimenuitem></term>
- <listitem>
- <para>
- Enable errors in authentication to be displayed to the
- user(s) in the GDM display.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Permissions:</guimenuitem></term>
- <listitem>
- <para>
- Determine the permission levels in relation to writable
- directories and files of other users. The
- <guimenuitem>World writable</guimenuitem> selection
- allows the GDM to view world writable files and
- directories. The <guimenuitem>Group
- writable</guimenuitem> selection allows the GDM to
- view only group writable files and
- directories. Finally, the
- <guimenuitem>Paranoia</guimenuitem> selection will
- only accept files and directories that the user owns.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>GDM runs as this
- user</guimenuitem></term>
- <listitem>
- <para>
- Allows the GDM to be run as the specified user.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>GDM runs as this
- group</guimenuitem></term>
- <listitem>
- <para>
- Allows the GDM to be run as the specified group.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>User 'auth'
- directory</guimenuitem></term>
- <listitem>
- <para>
- Allow the directory which contains the user's .Xauthority
- file to be specified
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>User 'auth' FB
- directory</guimenuitem></term>
- <listitem>
- <para>
- In case the gdm fails to update the user's .Xauthority file,
- a cookie will be created in the specified directory.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>User 'auth'
- File</guimenuitem></term>
- <listitem>
- <para>
- Specify the name of the file in which to store a user's
- cookies.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Retry delay</guimenuitem></term>
- <listitem>
- <para>
- Specify the number of seconds the GDM should wait
- before reactivating the entry field after a failed
- login attempt.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Maximum user file length</guimenuitem></term>
- <listitem>
- <para>
- Allows the maximum size of the largest
- readable/writable file to be specified. The GDM will
- refuse to read or write to a file bigger than the
- given value. The value is specified in bytes.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title>XDMCP</title>
- <varlistentry><term></term><listitem>
- <figure id="xdmcp-fig">
- <title>The XDMCP tab</title>
- <screenshot>
- <screeninfo>The XDMCP tab</screeninfo>
- <graphic fileref="figures/GDM_xdmcp" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Enable XDMCP</guimenuitem></term>
- <listitem>
- <para>
- Allow a remote X-terminal to request a session from
- the current host. Enabling this option makes visible
- the connection settings.(X Display Manager Control
- Protocol)
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Honour indirect
- requests</guimenuitem></term>
- <listitem>
- <para>
- Enable choosing for X-terminals which don't supply
- their own display browser.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Listen on UDP
- port</guimenuitem></term>
- <listitem>
- <para>
- Listen to UDP(user datagram protocol) requests on
- the specified port.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Maximum pending
- requests</guimenuitem></term>
- <listitem>
- <para>
- Restrict the GDM to a fixed size queue of the
- specified pending connections.
- <warning><title>Denial of Service
- Attacks</title>
- <para>
- This option has been included to avoid
- DOS(Denial of Service Attacks). This parameter
- only limits the number of allowed displays
- initiating a connection at any one given time,
- and does not limit the number of total remote
- displays which can be managed.
- </para>
- </warning>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Max pending indirect
- requests</guimenuitem></term>
- <listitem>
- <para>
- Allow only the specified number of displays with
- the host chooser at any one given time.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Maximum remote
- sessions</guimenuitem></term>
- <listitem>
- <para>
- Allow only the specified number of remote displays
- to be able to use the host.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Maximum wait
- time</guimenuitem></term>
- <listitem>
- <para>
- Wait for the specified amount of time in seconds
- before the requesting display is removed from the
- pending queue.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Maximum indirect wait
- time</guimenuitem></term>
- <listitem>
- <para>
- Wait for the specified amount of time, in seconds,
- between when a display requests a chooser and the
- completion of the protocol negotiation before
- removing display from the pending list.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Displays per host
- </guimenuitem></term>
- <listitem>
- <para>
- Specifies the number of displays that can run on any one host to be
- set.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Ping interval
- </guimenuitem></term>
- <listitem>
- <para>
- Specifies the interval, in minutes, that the gdm waits between
- issuing pings to make sure the display is still alive.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>
- </guimenuitem></term>
- <listitem>
- <para>
- Allows the specification of a script to run to set the willing
- headers sent by the manager.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title>X-server setup</title>
- <varlistentry><term></term>
- <listitem>
- <figure id="xservsetup-fig">
- <title>The xserver setup tab</title>
- <screenshot>
- <screeninfo>The xserver setup tab</screeninfo>
- <graphic fileref="figures/GDM_xserv_setup" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Servers
- </guimenuitem></term>
- <listitem>
- <para>
- Displays a list of server definitions. From the buttons on the
- right, one can create aliases for a specific server setup. Enabling
- a server as <guimenuoption>Flexible</guimenuoptions>, indicates that
- the server can be started on demand.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Static Servers
- </guimenuitem></term>
- <listitem>
- <para>
- Allows the selection of servers which run always run. By picking
- one of the server definitions via the buttons on the right, one can
- setup the desired static server(s).
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Always restart X servers</guimenuitem></term>
- <listitem>
- <para>
- Enable the X server to restart after every logout.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Standard X server
- </guimenuitem></term>
- <listitem>
- <para>
- Indicates the X server to be used and its respective path.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Xnest server
- </guimenuitem></term>
- <listitem>
- <para>
- Indicates the Xnest server to be used and its respective path.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Maximum number of flexible servers
- </guimenuitem></term>
- <listitem>
- <para>
- Indicates the maximum number of flexible servers, that may be
- running at any one given time.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Failsafe X server
- </guimenuitem></term>
- <listitem>
- <para>
- Indicates the Failsafe X server to be used and its respective path.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Script to run when X is crashing
- </guimenuitem></term>
- <listitem>
- <para>
- Indicates a script to run in the event on's X session keeps crashing.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>X configurator binaries to try
- </guimenuitem></term>
- <listitem>
- <para>
- Indicates which binaries to use when an X session, or X itself,
- crashes.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title>Login sessions</title>
- <varlistentry><term></term>
- <listitem>
- <figure id="loginsession-fig">
- <title>The Login sessions tab</title>
- <screenshot>
- <screeninfo>The Login sessions tab</screeninfo>
- <graphic fileref="figures/GDM_login_sessions" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Session
- directory</guimenuitem></term>
- <listitem>
- <para>
- The directory that contains script(s) to be run at the begining
- of a session
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Available Sessions</guimenuitem></term>
- <listitem>
- <para>
- List the available sessions in which to choose from. The selected
- session will appear in the <guimenuitem>Selected session name
- </guimenuitem> field. Under this field, the session script is
- displayed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Gnome Chooser</guimenuitem></term>
- <listitem>
- <para>
- If a session named Gnome is present, enable the Gnome Chooser
- session to be displayed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Gnome Failsafe</guimenuitem></term>
- <listitem>
- <para>
- Enable the Gnome Failsafe session to be displayed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Xterm Failsafe</guimenuitem></term>
- <listitem>
- <para>
- Enable the Xterm Failsafe session to be displayed.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Enable debugging
- output</guimenuitem></term>
- <listitem>
- <para>
- Allow debugging information to be displayed
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Add session</guimenuitem></term>
- <listitem>
- <para>
- Create and add a new session to be made available.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Remove session</guimenuitem></term>
- <listitem>
- <para>
- Delete the session selected in the <guimenuitem>Available
- Sessions</guimenuitem> menu.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Set as default</guimenuitem></term>
- <listitem>
- <para>
- Enable the selected session in the <guimenuitem>Available
- Sessions</guimenuitem> menu to be the default.
- </para>
- <note><title>Default session</title>
- <para>The current default session is indicated by a light blue
- highlight under the <guimenuitem>Available Sessions</guimenuitem>
- menu.
- </para>
- </note>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title>Miscellaneous</title>
- <varlistentry><term></term>
- <listitem>
- <figure id="misc-fig">
- <title>The Miscellaneous tab</title>
- <screenshot>
- <screeninfo>The Miscellaneous tab</screeninfo>
- <graphic fileref="figures/GDM_expert_misc" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Enable debugging output</guimenuitem></term>
- <listitem>
- <para>
- Enable the debugging output to be logged into the
- syslog file.
- </para>
- <caution>
- <title>Debug output to syslog</title>
- <para>
- Though a convieniant method to help track problems, this option, when
- selected, can fill up a system's log files rather quickly. This is
- not recommended for normal use
- </para>
- </caution>
- </listitem>
- </varlistentry>
- </variablelist>
-
-</sect1>
-
-<sect1 id="system">
- <title>The System Options</title>
- <para>
- System menus
- </para>
-
- <variablelist><title><guimenuitem>Paths</guimenuitem></title>
- <varlistentry><term></term>
- <listitem>
- <figure id="paths-fig">
- <title>The paths tab</title>
- <screenshot>
- <screeninfo>The paths tab</screeninfo>
- <graphic fileref="figures/GDM_paths" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Chooser
- command</guimenuitem></term>
- <listitem>
- <para>
- Allow selection and customization of the command
- that will activate the chooser.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Greeter
- command</guimenuitem></term>
- <listitem>
- <para>
- Allow selection and customization of the command
- that will activate the greeter.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Halt command</guimenuitem></term>
- <listitem>
- <para>
- Allow the specified command to halt the host
- machine
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Reboot
- command</guimenuitem></term>
- <listitem>
- <para>
- Allow the specified command to reboot the host
- machine
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Display initialization
- directory</guimenuitem></term>
- <listitem>
- <para>
- Display the directory that contains the scripts
- needed for the GDM initilization.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Logging
- directory</guimenuitem></term>
- <listitem>
- <para>
- Output logging information into a file(s) residing
- in the specified directory.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Session
- directory</guimenuitem></term>
- <listitem>
- <para>
- Set the specified directory as the directory that
- contains the scripts to start a session.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>PRE session scripts
- directory</guimenuitem></term>
- <listitem>
- <para>
- Look for scripts in the specified directory to run
- before starting a session.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>POST session scripts
- directory</guimenuitem></term>
- <listitem>
- <para>
- Look for scripts in the specified directory to run
- after ending a session.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>PID file</guimenuitem></term>
- <listitem>
- <para>
- Place the PID file(s) in the specified directory
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title><guimenu>Environment</guimenu></title>
- <varlistentry><term></term>
- <listitem>
- <figure id="enviro-fig">
- <title>The environment tab</title>
- <screenshot>
- <screeninfo>The environment tab</screeninfo>
- <graphic fileref="figures/GDM_enviro" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Default $PATH</guimenuitem</term>
- <listitem>
- <para>
- Set the default PATH variable ($PATH)
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Root $PATH</guimenuitem></term>
- <listitem>
- <para>
- Set the PATH of the Root user to the specified
- directories.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Locale file</guimenuitem></term>
- <listitem>
- <para>
- Set the specified file as the main locale file.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <variablelist><title><guimenu>Chooser</guimenu></title>
- <varlistentry><term></term>
- <listitem>
- <figure id="chooser-fig">
- <title>The chooser tab</title>
- <screenshot>
- <screeninfo>The chooser tab</screeninfo>
- <graphic fileref="figures/GDM_chooser" format="png"
- srccredit="Trevor Curtis">
- </graphic>
- </screenshot>
- </figure>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Directory for host
- images</guimenuitem></term>
- <listitem>
- <para>
- Set the specified directory as the directory to
- contain the images to represent hosts.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Default host
- image</guimenuitem></term>
- <listitem>
- <para>
- Set the selected image as the default image to
- represent hosts.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Scan every 'x'
- seconds</guimenuitem></term>
- <listitem>
- <para>
- Select the number of seconds after which host images are
- scanned
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-</sect1>
-
-<sect1 id="bugs">
- <title>Known Bugs and Limitations</title>
- <para>
- This application has no known bugs.
- </para>
-</sect1>
-
-<sect1 id="authors">
- <title>Authors</title>
- <para>
- <application>GDM Configure</application> was written by Lee Mallabone
- (<email>lee@fonicmonkey.net</email>). To find more information about
- <application>GDM Configure</application>, please visit the <ulink
- url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
- page</ulink>. Please send all comments, suggestions, and bug
- reports to the <ulink url="http://bugzilla.gnome.org" type="http">GNOME
- bug tracking database</ulink>. (Instructions for submitting bug
- reports can be found <ulink
- url="http://bugzilla.gnome.org/Reporting.html" type="http">
- on-line</ulink>.) You can also use <application>Bug Report
- Tool</application> (<command>bug-buddy</command>), available in the
- <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
- Menu</guimenu>, for submitting bug reports.
- </para>
-
- <para>
- This manual was written by Trevor Curtis
- (<email>tcurtis@somaradio.ca</email>). Please send all comments and
- suggestions regarding this manual to the <ulink type="http"
- url="http://developer.gnome.org/projects/gdp">GNOME Documentation
- Project</ulink> by sending an email to
- <email>docs@gnome.org</email>. You can also add your comments
- online by using the <ulink type="http"
- url="http://developer.gnome.org/projects/gdp/doctable/">GNOME
- Documentation Status Table</ulink>.
- </para>
-
- <!-- For translations: uncomment this:
-
- <para>
- Latin translation was done by ME
- (<email>MYNAME@MYADDRESS</email>). Please send all comments and
- suggestions regarding this translation to SOMEWHERE.
- </para>
- -->
-
-</sect1>
-
-<sect1 id="license">
- <title>License</title>
- <para>
- This program is free software; you can redistribute it and/or
- modify it under the terms of the <ulink type="help" url="gnome-help:gpl">
- <citetitle>GNU General Public License</citetitle></ulink> as
- published by the Free Software Foundation;
- either version 2 of the License, or (at your option) any later
- version.
- </para>
- <para>
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- <citetitle>GNU General Public License</citetitle> for more details.
- </para>
- <para>
- A copy of the <citetitle>GNU General Public License</citetitle> is
- included as an appendix to the <citetitle>GNOME Users
- Guide</citetitle>. You may also obtain a copy of the
- <citetitle>GNU General Public License</citetitle> from the Free
- Software Foundation by visiting <ulink type="http"
- url="http://www.fsf.org">their Web site</ulink> or by writing to
- <address>
- Free Software Foundation, Inc.
- <street>59 Temple Place</street> - Suite 330
- <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
- <country>USA</country>
- </address>
- </para>
-</sect1>
-</article>