<chapter id="gdm-0">
  <title>Configuring GDM</title>
  <highlights>
    <para>This chapter describes how to configure <application>GDM</application> in the GNOME Desktop.</para>
  </highlights>
  <sect1 id="gdm-1">
    <title>Introduction to GDM</title>
    <indexterm>
      <primary>GDM</primary>
      <secondary>introduction</secondary>
    </indexterm>
    <para>To start a GNOME Desktop session, users must log in to authenticate
their identity. The login screen provides gateway to the desktop environment
for the user. The <application>GNOME Display Manager</application> (<application>GDM</application>) application controls the login screen. </para>
    <para><application>GDM</application> also enables you to log in to another
session without closing the current session.</para>
  </sect1>
  <sect1 id="gdm-2">
    <title>Configuring GDM</title>
    <indexterm>
      <primary>GDM</primary>
      <secondary>configuring</secondary>
    </indexterm>
    <para>To configure <application>GDM</application>, use the <application>GDM
Configurator</application> application. To open <application>GDM Configurator</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>System Tools</guisubmenu><guimenuitem>GDM Configurator</guimenuitem></menuchoice>.</para>
    <para>You can configure <application>GDM</application> in the following functional
areas:</para>
    <itemizedlist>
      <listitem>
        <para>
          <guilabel>General</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Standard greeter</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Graphical greeter</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>Security</guilabel>
        </para>
      </listitem>
      <listitem>
        <para>
          <guilabel>XDMCP</guilabel>
        </para>
      </listitem>
    </itemizedlist>
    <sect2 id="gdm-3">
      <title>General Settings</title>
      <para>Use the <guilabel>General</guilabel> tabbed section to set general GDM
preferences.</para>
      <para><xref linkend="gdm-TBL-8"/> lists the general GDM settings that you can
configure.</para>
      <table frame="topbot" id="gdm-TBL-8">
        <title>General GDM Settings</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colwidth="50*"/>
          <colspec colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Local</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information
to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Remote</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Always use 24 hour clock format</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Login a user automatically on first bootup</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Automatic login username</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Login a user automatically after a specified number
of seconds</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided
in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Timed login username</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Seconds before login</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="gdm-4">
      <title>Standard Greeter Settings</title>
      <para>Use the <guilabel>Standard greeter</guilabel> tabbed section to set
preferences for the standard greeter.</para>
      <para><xref linkend="gdm-TBL-9"/> lists the standard greeter settings that
you can configure.</para>
      <table frame="topbot" id="gdm-TBL-9">
        <title>Standard Greeter Settings</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec2" colwidth="50*"/>
          <colspec colname="colspec3" colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Logo</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information
to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Welcome string</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Show choosable user images (face browser)</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>No background</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec2">
                <para>
                  <guilabel>Image</guilabel>
                </para>
              </entry>
              <entry colname="colspec3">
                <para/>
              </entry>
            </row>
            <row>
              <entry colname="colspec2">
                <para>
                  <guilabel>Color</guilabel>
                </para>
              </entry>
              <entry colname="colspec3">
                <para/>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Scale background image to fit</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Only color on remote displays</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Background color</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="gdm-5">
      <title>Graphical Greeter Settings</title>
      <para>Use the <guilabel>Graphical greeter</guilabel> tabbed section to set
preferences for the graphical greeter.</para>
      <para><xref linkend="gdm-TBL-10"/> lists the graphical greeter settings that
you can configure.</para>
      <table frame="topbot" id="gdm-TBL-10">
        <title>Graphical Greeter Settings</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colwidth="50*"/>
          <colspec colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>Greeter list</para>
              </entry>
              <entry>
                <para>Information to be
provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guibutton>Install new theme</guibutton>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="gdm-6">
      <title>Security Settings</title>
      <para>Use the <guilabel>Security</guilabel> tabbed section to set security
preferences for GDM.</para>
      <para><xref linkend="gdm-TBL-11"/> lists the security settings that you can
configure.</para>
      <table frame="topbot" id="gdm-TBL-11">
        <title>Security Settings</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colwidth="50*"/>
          <colspec colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Allow root to login with GDM</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Allow root to login remotely with GDM</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Allow remote timed logins</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Show system menu</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Allow configuration from the login screen</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Retry delay (seconds)</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
    <sect2 id="gdm-7">
      <title>XDMCP Settings</title>
      <para>Use the <guilabel>XDMCP</guilabel> tabbed section to set preferences
for XDMCP.</para>
      <para><xref linkend="gdm-TBL-12"/> lists the XDMCP settings that you can configure.</para>
      <table frame="topbot" id="gdm-TBL-12">
        <title>XDMCP Settings</title>
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="50*"/>
          <colspec colname="colspec1" colwidth="50*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para>Element</para>
              </entry>
              <entry>
                <para>Description</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <para>
                  <guilabel>Enable XDMCP</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Honour indirect requests</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Listen on UDP port</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Maximum pending requests</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Max pending indirect requests</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Maximum remote sessions</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Maximum wait time</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  <guilabel>Maximum indirect wait time</guilabel>
                </para>
              </entry>
              <entry>
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0">
                <para>
                  <guilabel>Displays per host</guilabel>
                </para>
              </entry>
              <entry colname="colspec1">
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0">
                <para>
                  <guilabel>Ping interval (minutes)</guilabel>
                </para>
              </entry>
              <entry colname="colspec1">
                <para>Information to be provided in a future release.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="gdm-13">
    <title>Logging in to a New Session</title>
    <indexterm>
      <primary>GDM</primary>
      <secondary>logging in to new session</secondary>
    </indexterm>
    <indexterm>
      <primary>New login application</primary>
    </indexterm>
    <para>To log in to a new session, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>System Tools</guisubmenu><guimenuitem>New login</guimenuitem></menuchoice>. A login screen is displayed. Enter your username
and password to log in.</para>
  </sect1>
</chapter>
