<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY version "2.26.0">
<!ENTITY date "02/10/2009">
<!ENTITY mdash "&#8212;">
<!ENTITY percnt "&#x0025;">
]>
<article id="index" lang="en">
  <articleinfo>
    <title>GNOME-Anmeldefenster-Referenzhandbuch</title>

    <revhistory>
      <revision>
        <revnumber>0.0</revnumber>
        <date>2008-09</date>
      </revision>
    </revhistory>

    <abstract role="description">
      <para>GDM ist das Anmeldefenster für GNOME, ein Programm zur grafischen Anmeldung am System.</para>
    </abstract>

    <authorgroup>
      <author>
        <firstname>Martin</firstname><othername>K.</othername>
           <surname>Petersen</surname>
        <affiliation>
          <address><email>mkp@mkp.net</email></address>
        </affiliation>
      </author>
      <author>
        <firstname>George</firstname><surname>Lebl</surname>
        <affiliation>
          <address><email>jirka@5z.com</email></address>
        </affiliation>
      </author>
      <author>
        <firstname>Jon</firstname><surname>McCann</surname>
        <affiliation>
          <address><email>mccann@jhu.edu</email></address>
        </affiliation>
      </author>
      <author>
        <firstname>Ray</firstname><surname>Strode</surname>
        <affiliation>
          <address><email>rstrode@redhat.com</email></address>
        </affiliation>
      </author>
      <author role="maintainer">
        <firstname>Brian</firstname><surname>Cameron</surname>
        <affiliation>
          <address><email>Brian.Cameron@Oracle.COM</email></address>
        </affiliation>
      </author>
    </authorgroup>
    <copyright>
      <year>1998</year>
      <year>1999</year>
      <holder>Martin K. Petersen</holder>
    </copyright>
    <copyright>
      <year>2001</year>
      <year>2003</year>
      <year>2004</year>
      <holder>George Lebl</holder>
    </copyright>
    <copyright>
      <year>2003</year>
      <year>2007</year>
      <year>2008</year>
      <holder>Red Hat, Inc.</holder>
    </copyright>
    <copyright>
      <year>2003</year>
       <year>2011</year>
       <holder>Oracle and/or its affiliates. All rights reserved.</holder>
    </copyright>

    

    <releaseinfo>Dieses Handbuch beschreibt Version 2.26.0 des GNOME-Anmeldefensters. Es wurde zuletzt am 20.07.2009 aktualisiert.</releaseinfo>  
  </articleinfo>

  <!-- ============= Preface ================================== -->

  <sect1 id="preface">
    <title>Begriffe und Schreibweisen, die in diesem Handbuch verwendet werden</title>

    <para>Dieses Handbuch beschreibt Version 2.26.0 des GNOME-Anmeldefensters. Es wurde zuletzt am 20.07.2009 aktualisiert.</para>  

    <para>
      Chooser - A program used to select a remote host for managing a
      display remotely on the attached display (<command>gdm-host-chooser</command>).
    </para>

    <para>
      FreeDesktop - The organization providing desktop standards, such as the
      Desktop Entry Specification used by GDM.
      <ulink type="http" url="http://www.freedesktop.org/">
      http://www.freedesktop.org</ulink>.
    </para>
    <para>GDM - GNOME Anmeldefenster. Diese Bezeichnung wird zur Beschreibung des Softwarepakets als Ganzes verwendet.</para>

    <para>
      Greeter - The graphical login window (provided by <command>gnome-shell</command>).
    </para>

    <para>PAM - Pluggable Authentication Mechanism</para>

    <para>XDMCP - X Displaymanager-Protokoll</para>

    <para>
      Xserver - An implementation of the X Window System.  For example the
      Xorg Xserver provided by the X.org Foundation
      <ulink type="http" url="http://www.x.org/">http://www.x.org</ulink>.
    </para>

    <para>
      Paths that start with a word in angle brackets are relative to the
      installation prefix. I.e. <filename>&lt;share&gt;/pixmaps/</filename>
      refers to <filename>/usr/share/pixmaps</filename> if GDM was
      configured with <command>--prefix=/usr</command>.
    </para>
  </sect1>

  <!-- ============= Overview ================================= -->

  <sect1 id="overview">
    <title>Überblick</title>

    <sect2 id="introduction">
      <title>Einführung</title>

      <para>Das Gnome-Anmeldefenster (GDM) ist ein Anmeldebildschirm, der über alle wichtigen Merkmale verfügt, um lokale oder entfernte Anzeigen zu verwalten. GDM wurde komplett neu geschrieben und enthält keinen Code aus XDM oder anderweitig vom X-Konsortium stammenden Code.</para>

      <para>Beachten Sie, dass GDM in hohem Maße konfigurierbar ist. Viele Einstellungen können die Systemsicherheit beeinflussen. Punkte, die Sie besonders beachten sollten, werden in diesem Dokument hervorgehoben dargestellt.</para> 

      <para>Bitte beachten Sie, dass GDM auf einigen Betriebssystemen abweichend von den in diesem Dokument beschriebenen Standardwerten vorkonfiguriert wird. Falls GDM von diesem Dokument abzuweichen scheint, dann prüfen Sie bitte, ob die diesbezügliche Konfiguration von der hier beschriebenen abweichen darf.</para>

      <para>
        For further information about GDM, refer to the project website at
        <ulink type="http" url="http://wiki.gnome.org/Projects/GDM/">
        http://wiki.gnome.org/Projects/GDM</ulink>.
      </para>

      <para>
        For discussion or queries about GDM, refer to the discussion forum at
        <ulink type="http" url="https://discourse.gnome.org/tag/gdm">
        https://discourse.gnome.org/tag/gdm</ulink>.
        The archives of the previous mailing list are also a good resource to
        check to seek answers to common questions. The list was archived at
        <ulink type="http" url="https://mail.gnome.org/archives/gdm-list/">
        https://mail.gnome.org/archives/gdm-list/</ulink> and has a search
        facility to look for messages with keywords.
      </para>

      <para>
        Please submit any bug reports or enhancement requests to
        <ulink type="http" url="https://gitlab.gnome.org/GNOME/gdm/-/issues/">
        https://gitlab.gnome.org/GNOME/gdm/-/issues/</ulink>.
      </para>
    </sect2>

    <sect2 id="stability">
      <title>Stabilität der Schnittstelle</title>

      <para>GDM 2.20 und ältere Versionen unterstützen stabile Schnittstellen zur Konfiguration. Die Codebasis wurde jedoch für GDM 2.22 vollständig neu geschrieben und ist nicht gänzlich kompatibel mit älteren Versionen. Dies liegt einerseits daran, dass es anders arbeitet und einige Optionen überflüssig werden oder noch nie sinnvoll waren und andererseits, dass einige Funktionalität noch nicht wieder implementiert worden ist.</para>

      <para>
        Interfaces which continue to be supported in a stable fashion include
        the Init, PreSession, PostSession, PostLogin, and Xsession scripts.
        Some daemon configuration options in the 
        <filename>&lt;etc&gt;/gdm/custom.conf</filename> file continue to be
        supported.  Also, the <filename>~/.dmrc</filename>, and face browser
        image locations are still supported.
      </para>

      <para>GDM 2.20 und ältere verfügten über die Fähigkeit, mehrere Bildschirme über verschiedene Grafikkarten anzusteuern. Sie kommt zur Anwendung in Umgebungen mit Terminal Server, einem Anmeldefenster mittels eines Programms wie Xnest oder Xephyr, dem Programm »gdmsetup«, XML-basierten Themen des Begrüßungsbildschirms. Es wurde auch die Fähigkeit unterstützt, den XDMCP-Wähler vom Anmeldebildschirm aus zu starten. Diese Merkmale wurden nicht während der Neuprogrammierung für 2.22 hinzugefügt.</para>

    </sect2>

    <sect2 id="functionaldesc">
      <title>Funktionsbeschreibung</title>

<!--
<para>
        TODO - Would be good to discuss D-Bus, perhaps the new GObject model,
               and to explain the reasons why the rewrite made GDM better.
               From a high-level overview perspective, rather than the
               technical aspects.
</para>
-->

      <para>GDM ist für die Verwaltung der Anzeigen des Systems zuständig. Dies beinhaltet die Legitimation der Benutzer, den Start und das Beenden der Benutzersitzung. GDM ist konfigurierbar, die diesbezüglichen Möglichkeiten werden im Abschnitt »GDM konfigurieren« in diesem Dokument beschrieben. GDM ist auch von Benutzern mit Behinderungen nutzbar.</para>

      <para>GDM ermöglicht die Verwaltung der Hauptanzeige und über VT (Xserver Virtual Terminal) gestarteter Anzeigen. Es ist integriert in andere Anwendungen wie dem Benutzerwechsel und dem GNOME Bildschirmschoner, um mehrere Anzeigen auf der lokalen Konsole über die VT-Schnittstelle zu verwalten. Es kann auch XDMCP-Anzeigen verwalten.</para>

      <para>
        Regardless of the display type, GDM will do the following when it
        manages the display.  It will start an Xserver process, then run the
        <filename>Init</filename> script as the root user, and start the
        greeter program on the display.
      </para>

      <para>
        The greeter program is run as the unprivileged "gdm"
        user/group.  This user and group are described in the
        "Security" section of this document.  The main functions of
        the greeter program are to provide a mechanism for selecting
        an account for log in and to drive the dialogue between
        the user and system when authenticating that account. The authentication
        process is driven by Pluggable Authentication Modules (PAM).  The PAM
        modules determine what prompts (if any) are shown to the user to
        authenticate.  On the average system, the greeter program will request
        a username and password for authentication.  However some systems may
        be configured to use supplemental mechanisms such as a fingerprint or
        SmartCard readers. GDM can be configured to support these
        alternatives in parallel with greeter login extensions and the
        <command>--enable-split-authentication</command>
        <filename>./configure</filename> option, or one at a
        time via system PAM configuration.
      </para>

      <para>
         The smartcard extension can be enabled or disabled via the
         <filename>org.gnome.display-manager.extensions.smartcard.active</filename>
         gsettings key.
      </para>

      <para>
         Likewise, the fingerprint extension can be enabled or disabled via the
         <filename>org.gnome.display-manager.extensions.fingerprint.active</filename>
         gsettings key.
      </para>

      <para>GDM und PAM können so konfiguriert werden, dass keinerlei Eingabe erforderlich ist und automatisch ein Benutzer angemeldet und eine Sitzung gestartet wird. Das kann in bestimmten Umgebungen sinnvoll sein, zum Beispiel auf Systemen mit einem einzigen Benutzer oder für öffentlich aufgestellte Rechner.</para>

      <para>
        In addition to authentication, the greeter program allows the user to
        select which session to start and which language to use.  Sessions are
        defined by files that end in the .desktop suffix and more information
        about these files can be found in the "GDM User Session and Language
        Configuration" section of this document.  By default, GDM is configured
        to display a face browser so the user can select their user account by
        clicking on an image instead of having to type their username. GDM
        keeps track of the user's default session and language in the user's
        <filename>~/.dmrc</filename> and will use these defaults if the user
        did not pick a session or language in the login GUI.
      </para>

      <para> 
        After authenticating a user, the daemon runs the
        <filename>PostLogin</filename> script as root, then runs the  
        <filename>PreSession</filename> script as root.  After running these
        scripts, the user session is started.  When the user exits their 
        session, the <filename>PostSession</filename> script is run as root.
        These scripts are provided as hooks for distributions and end-users
        to customize how sessions are managed.  For example, using these 
        hooks you could set up a machine which creates the user's $HOME
        directory on the fly, and erases it on logout.  The difference 
        between the <filename>PostLogin</filename> and
        <filename>PreSession</filename> scripts is that
        <filename>PostLogin</filename> is run before the pam_open_session call
        so is the right place to do anything which should be run before the
        user session is initialized.  The <filename>PreSession</filename>
        script is called after session initialization.
      </para>
    </sect2>

    <sect2 id="greeterpanel">
      <title>Das Panel des Begrüßers</title>
      <para>Das GDM-Anmeldefenster zeigt ein Panel auf dem unteren Bildschirmrand, das weitere Funktionen zur Verfügung stellt. Sobald ein Benutzer ausgewählt wurde, ermöglicht das Panel die Wahl einer Sitzung, einer Sprache und einer Tastaturbelegung für den Zeitraum nach der Anmeldung. Der Belegungswähler belegt die Tastatur entsprechend auch bei Eingabe des Passwortes. Das Panel beinhaltet ebenfalls einen Bereich für Statussymbole von Anmeldediensten. Beispiele für Statussymbole sind ein Symbol für den Ladezustand des Akkus und die Aktivierung der Barrierefreiheit. Im Anmeldefenster werden auch Knöpfe zum Herunterfahren oder Neustart des Systems angezeigt.GDM kann nach Wunsch so konfiguriert werden, dass die Knöpfe nicht angezeigt werden. GDM kann auch mittels »PolicyKit« (oder mittels »RBAC« in Oracle Solaris) so eingestellt werden, dass eine Legitimierung für ein Herunterfahren oder für einen Neustart angefordert wird.</para>

      <para>Beachten Sie, dass die Merkmale zur Tastaturbelegung nur auf Systemen verfügbar sind, die »libxklavier« unterstützen.</para>
    </sect2>

    <sect2 id="accessibility">
      <title>Barrierefreiheit</title>

        <para>GDM unterstützt die »Barrierefreie Anmeldung«, welche den Benutzern die Anmeldung an ihrer Sitzung erlaubt, die nicht auf die übliche Weise den Bildschirm, die Maus oder die Tastatur nutzen können. Barrierefreiheits-(AT)-Technologien wie Bildschirmtastatur, Bildschirmleser, Bildschirmlupe und der AccessX-Tastaturzugriff des X-Servers sind verfügbar. Es ist ebenso möglich, den Text zu vergrößern oder kontrastreiche Symbole oder Bedienelemente zu verwendet, falls dies erforderlich ist. Ziehen Sie den Abschnitt »Konfiguration der Barrierefreiheit« dieses Dokuments zu Rate, um weitere Informationen über die verschiedenen Barrierefreiheitsfunktionen zu erhalten.</para>

        <para>Auf einigen Betriebssystemen kann es notwendig sein, dass der Benutzer »gdm« Mitglied der Gruppe »audio« ist, um Barrierefreiheits-Programmen die Audioausgabe (z.B. bei Umwandlung von Text in Sprache) zu ermöglichen.</para>
    </sect2>

    <sect2 id="facebrowser">
      <title>Das GDM-Benutzeralbum</title>

      <para>Das Benutzeralbum ist die Oberfläche, welche es Benutzern ermöglicht, Ihren Benutzernamen durch Klicken mit der Maus auf ein Foto auszuwählen. Dieses Sondermerkmal kann über den GSettings-Schlüssel »org.gnome.login-screen disable-user-list« ein- oder ausgeschaltet werden. Wenn es ausgeschaltet ist, müssen die Benutzer Ihren vollständigen Benutzernamen eingeben. Wenn es eingeschaltet ist, werden alle lokalen Benutzer angezeigt, die sich am System anmelden dürfen (alle Benutzerkonten, die in der Datei »/etc/passwd« definiert sind und eine gültige Shell und eine genügend große Benutzerkennzahl haben) sowie entfernte Benutzer, die sich vor kurzem angemeldet haben. Die Benutzeralben in GDM 2.20 und ältere versuchen alle entfernten Benutzer anzuzeigen, was zu Problemen in großen Unternehmensnetzen führte.</para>

      <para>Im Benutzeralbum werden die Benutzer mit den häufigsten Anmeldungen im oberen Bereich der Liste angezeigt. Dadurch wird sichergestellt, dass die Benutzer mit den häufigsten Anmeldungen ihr Bild schneller finden können.</para>

      <para>Das Benutzeralbum unterstützt Suchen-beim-Eingeben, was dynamisch die Auswahl anpasst, während der Benutzer seinen entsprechenden Benutzernamen aus der Liste eingibt. Dies bedeutet, dass ein Benutzer mit einem langem Benutzernamen nur die ersten Buchstaben eingeben muss, um den gewünschten Eintrag in der Liste auszuwählen.</para>

      <para>
        The icons used by GDM can be installed globally by the sysadmin or can
        be located in the user's home directories.  If installed globally
        they should be in the <filename>&lt;share&gt;/pixmaps/faces/</filename>
        directory and the filename should be the name of the user.  Face image
        files should be a standard image that GTK+ can read, such as PNG or
        JPEG.  Face icons placed in the global face directory must be readable
        to the GDM user.
      </para>

<!--
<para>
        TODO - In the old GDM the ~/gnome2/gdm file is used, but the new code
               seems to use ~/.gnome/gdm.  Error?
</para>
-->
      <para>
        If there is no global icon for the user, GDM will look in the user's
        $HOME directory for the image file.  GDM will first look for the user's
        face image in <filename>~/.face</filename>.  If not found, it will try 
        <filename>~/.face.icon</filename>.  If still not found, it will use the
        value defined for "face/picture=" in the 
        <filename>~/.gnome2/gdm</filename> file.
      </para>

      <para>Falls ein Benutzer keine definierte Bilddatei hat, verwendet GDM das Symbol »stock_person« des aktuellen GTK+-Themas. Wenn ein solches Bild nicht definiert ist, dann wird ein generisches Benutzerbild verwendet.</para>

      <para>Bitte beachten Sie, dass das Laden und Skalieren der Benutzerbilder aus entfernten persönlichen Ordnern viel Zeit in Anspruch nehmen kann. Weil es unpraktikabel ist, Bilder über NIS oder NFS zu laden, versucht GDM keine Bilder aus entfernten persönlichen Ordnern zu laden.</para>

      <para>Wenn das Benutzeralbum aktiviert ist, werden auf dem Computer vorhandene gültige Benutzernamen für jeden sichtbar dargestellt. Dies schränkt natürlich in gewissem Maße die Sicherheit ein, weil ein böswilliger Benutzer die gültigen Benutzernamen nicht sehen sollte. In einigen sehr sicherheitskritischen Umgebungen sollte das Benutzeralbum nicht verwendet werden.</para>

    </sect2>

    <sect2 id="xdmcp">
      <title>XDMCP</title>

<!--
<para>
        TODO - What XDMCP features actually work?   I know that the
               chooser is missing.
</para>
-->

      <para>Der GDM-Dienst kann so eingestellt werden, dass auf »X Display Manage Protocol (XDMCP)«-Anfragen von entfernten Anzeigen reagiert wird und diese bearbeitet werden. Nach Vorgabe ist die Unterstützung für XDMCP nicht abgeschaltet, kann aber auf Wunsch aktiviert werden. Wenn GDM mit Unterstützung für »TCP Wrapper« erstellt wurde, so wird der Dienst nur Zugriff von Rechnern zulassen, die im Abschnitt »GDM service« in der Konfigurationsdatei von »TCP Wrappers« festgelegt sind.</para>

      <para>GDM enthält verschiedene Mechanismen, die es robuster gegenüber Überlastungsangriffen auf den XDMCP-Dienst machen. Sehr viele Protokollparameter wie Handshake-Zeitabläufe usw. können fein abgestimmt werden. Die vorausgewählte Konfiguration sollte auf den meisten Systemen vernünftig funktionieren.</para>

      <para>Laut Voreinstellung lauscht GDM auf XDMCP-Anfragen auf dem für XDMCP üblichen Port 177 und antwortet auf »QUERY«- und »BROADCAST_QUERY«-Anfragen mit einem »WILLING«-Paket an den Initiator.</para>

      <para>GDM kann auch konfiguriert werden, um »INDIRECT«-Anfragen zu berücksichtigen und eine Rechnerauswahl dem entfernten Bildschirm zu präsentieren. GDM wird sich die Benutzerwahl merken und folgende Anfragen an den gewählten Verwalter weiterleiten. Es unterstützt ebenfalls eine Erweiterung zum Protokoll, die die Umleitung bei erfolgreicher Verbindung vergisst. Diese Erweiterung wird nur unterstützt, wenn beide Dienste durch GDM bereit gestellt werden. Sie ist transparent und wird von XDM oder anderen XDMCP-Diensten ignoriert.</para>

      <para>
        If XDMCP seems to not be working, make sure that all machines are
        specified in <filename>/etc/hosts</filename>.
      </para>

      <para>Informationen über Sicherheitsaspekte bei der Verwendung von XDMCP finden Sie im Abschnitt »Sicherheit«.</para>
    </sect2>

    <sect2 id="logging">
      <title>Protokollführung</title>

      <para>
        GDM uses syslog to log errors and status.  It can also log debugging
        information, which can be useful for tracking down problems if GDM is
        not working properly.  Debug output can be enabled by setting the
        debug/Enable key to "true" in the
        <filename>&lt;etc&gt;/gdm/custom.conf</filename> file.
      </para>

      <para>
        Output from the various Xservers is stored in the GDM log directory,
        which is normally <filename>&lt;var&gt;/log/gdm/</filename>.  Any
        Xserver messages are saved to a file associated with the display value,
        <filename>&lt;display&gt;.log</filename>.  
      </para>

      <para>
        The session output is piped through the GDM daemon to the
        <filename>~/<replaceable>$XDG_CACHE_HOME</replaceable>/gdm/session.log</filename>
        file which usually expands to <filename>~/.cache/gdm/session.log</filename>.
        The file is overwritten on each login, so logging out and logging back
        into the same user via GDM will cause any messages from the previous
        session to be lost.
      </para>

      <para>
        Note that if GDM can not create this file for some reason, then a
        fallback file will be created named <filename>~/<replaceable>$XDG_CACHE_HOME</replaceable>/gdm/session.log.XXXXXXXX</filename>
        where the <filename>XXXXXXXX</filename> are some random characters.
      </para>
    </sect2>

    <sect2 id="fusa">
      <title>Schneller Benutzerwechsel</title>

      <para>GDM ermöglicht es, dass mehrere Benutzer gleichzeitig angemeldet sind. Sobald ein Benutzer angemeldet ist, können sich weitere Benutzer über den Benutzerwechsler, über das GNOME-Panel oder über den Knopf »Benutzer wechseln« im Dialog des Bildschirmschoners anmelden. Die aktive Sitzung kann beliebig mit dem selben Verfahren gewählt werden. Beachten Sie, dass einige Distributionen den Benutzerwechsler nicht per Vorgabe zum Panel hinzufügen. Er kann über das Panelmenü jederzeit hinzugefügt werden.</para>
      <para>Beachten Sie, dass diese Funktion nur auf Systemen verfügbar ist, die »Virtuelle Terminals« unterstützen. Falls diese nicht unterstützt werden, arbeitet diese Funktion nicht.</para>
    </sect2>
  </sect1>

  <!-- ============= Security ================================= -->

  <sect1 id="security">
    <title>Sicherheit</title>

    <sect2 id="gdmuser">
      <title>Der Benutzer GDM und die Gruppe GDM</title>

      <para>Aus Sicherheitsgründen werden ein dedizierter Benutzer und eine Gruppenkennung für den ordnungsgemäßen Betrieb empfohlen. Benutzer und Gruppe heißen normalerweise »gdm« auf den meisten Systemen, können aber beliebig benannt werden. Alle grafischen GDM-Benutzeroberflächen werden unter diesem Benutzerkonto gestartet, das heißt alle Programme laufen in der eigenen Umgebung des Benutzerkontos. Das Konto und die Gruppe sollten eingeschränkte Rechte haben.</para>

      <para>
        The only special privilege the "gdm" user requires is the
        ability to read and write Xauth files to the
        <filename>&lt;var&gt;/run/gdm</filename> directory.  The
        <filename>&lt;var&gt;/run/gdm</filename> directory should have
        root:gdm ownership and 1777 permissions.
      </para>

      <para>
        You should not, under any circumstances, configure the GDM user/group
        to a user which a user could easily gain access to, such as the user
        <filename>nobody</filename>.  Any user who gains access to an Xauth
        key can snoop on and control running GUI programs running in the
        associated session or perform a denial-of-service attack on it.  It
        is important to ensure that the system is configured properly so that
        only the "gdm" user has access to these files and that it
        is not easy to login to this account.  For example, the account should
        be setup to not have a password or allow non-root users to login to the
        account.
      </para>

      <para>Die Konfiguration des GDM-Begrüßers wird in GConf gespeichert. Um dem Benutzer »gdm« die Speicherung der Konfiguration zu ermöglichen, benötigt dieser einen schreibbaren persönlichen Ordner ($HOME). Die Benutzer dürfen die vorgegebenen GConf-Einstellungen dahingehend ändern, dass der Benutzer »gdm« auf einen solchen Ordner verzichten kann. Allerdings könnten einige GDM-Funktionen nicht verfügbar sein, falls das Speichern von Statusinformationen in den GConf-Einstellungen nicht möglich ist.</para>
    </sect2>

    <sect2 id="PAM">
      <title>PAM</title>

      <para>GDM verwendet PAM für die Legitimation beim Anmelden. Die Abkürzung PAM steht für »Pluggable Authentication Module« und wird von den meisten Programmen auf Ihrem Computer verwendet, die eine Legitimation erfordern. Dies ermöglicht dem Systemverwalter, ein spezifisches Anmeldeverhalten für verschiedene Anmeldeprogramme einzustellen, wie beispielsweise SSH, grafische Anmeldung, Bildschirmschoner usw.</para>

      <para>PAM ist kompliziert und umfangreich konfigurierbar. Diese Dokumentation beabsichtigt nicht die Konfiguration detailliert zu erklären, es wird jedoch ein Überblick gegeben, wie sich die PAM-Konfiguration auf GDM bezieht, und wie PAM allgemein mit GDM konfiguriert wird. Es wird vorausgesetzt, dass jemand, der PAM konfigurieren will, sich auch weiter in die PAM-Dokumentation vertiefen müsste, um die Konfiguration von PAM und die in diesem Abschnitt verwendeten Begriffe zu verstehen.</para>
        
      <para>
        PAM configuration has different, but similar, interfaces on different
        Operating Systems, so check the
        <ulink type="help" url="man:pam.d">pam.d</ulink> or
        <ulink type="help" url="man:pam.conf">pam.conf</ulink> man page for
        details.  Be sure you read the PAM documentation and are comfortable
        with the security implications of any changes you intend to make to
        your configuration.
      </para>

      <para>Beachten Sie, dass GDM per Vorgabe den PAM-Dienstnamen »gdm« für die normale Anmeldung und den PAM-Dienstnamen »gdm-autologin« für die automatische Anmeldung verwendet. Diese Dienste dürften nicht in Ihren Konfigurationsdateien »pam.d« oder »pam.conf« definiert sein. Falls dort kein Eintrag existiert, wendet GDM das vorgegebene PAM-Verhalten an. Auf den meisten Systemen funktioniert das recht gut. Allerdings funktioniert die automatische Anmeldung nicht, wenn der Dienst »gdm-autologin« nicht definiert ist.</para>

      <para>
        The <filename>PostLogin</filename> script is run before
        pam_open_session is called, and the <filename>PreSession</filename>
        script is called after.  This allows the system administrator to add
        any scripting to the login process either before or after PAM 
        initializes the session.
      </para>

      <para>Wenn Sie möchten, dass GDM mit anderen Authentifizierungsmechanismen wie Fingerabdruckerkennung oder SmartCard-Lesegeräten zusammenarbeitet, sollten Sie dies als PAM-Servicemodul implementieren, anstatt den GDM-Code direkt zu verändern. Ziehen Sie die PAM-Dokumentation Ihres Systems zu Rate.</para>

      <para>PAM hat einige Einschränkungen bezüglich der Fähigkeit, mit mehreren Legitimationsarten gleichzeitig umzugehen, wie die Unterstützung für sowohl die Anmeldung mittels SmartCard als auch über die Eingabe von Benutzername und Passwort im Anmeldeprogramm. Es gibt jedoch Möglichkeiten, dass auch das funktioniert. Am besten ist es, beim Erstellen einer solchen Konfiguration zunächst nach allgemein funktionierenden Lösungen für dieses Problem zu suchen.</para>

      <para>Falls die automatische Anmeldungen auf einem System nicht funktioniert, überprüfen Sie, ob der Abschnitt »gdm-autologin« in der Konfiguration von PAM definiert ist. Damit sie funktioniert, ist es erforderlich ein PAM-Modul zu verwenden, das gar keine Legitimierung durchführt, oder das einfach »PAM_SUCCESS« aus allen öffentlichen Schnittstellen zurückgibt. Wenn man davon ausgeht, dass ein System das PAM-Modul »pam_allow.so« installiert hat, welches genau dies tut, so würde eine PAM-Konfiguration zum Einschalten von »gdm-autologin« folgendermaßen aussehen:</para>

<screen>
       gdm-autologin auth  required    pam_unix_cred.so.1
       gdm-autologin auth  sufficient  pam_allow.so.1
       gdm-autologin account  sufficient  pam_allow.so.1
       gdm-autologin session  sufficient  pam_allow.so.1
       gdm-autologin password  sufficient  pam_allow.so.1
</screen>

      <para>Die obige Konfiguration wird keinen lastlog-Eintrag erzeugen. Falls ein Eintrag gewünscht wird, verwenden Sie die folgende für die Sitzung:</para>

<screen>
       gdm-autologin session required pam_unix_session.so.1
</screen>

      <para>Wenn der Computer von verschiedenen Benutzern verwendet wird, ist eine automatische Anmeldung nicht sinnvoll, aber vielleicht möchten Sie einigen Benutzern eine Anmeldung ohne Passwort ermöglichen. Dieses Merkmal kann einzeln für jeden Benutzer mit dem Werkzeug »Benutzer und Gruppen« aktiviert werden; es wird durch Zuweisen des Benutzers zur Benutzergruppe »nopasswdlogin« vor Eingabe eines Passwortes erreicht. Damit es funktioniert muss die PAM-Konfigurationsdatei für den Service »gdm« z. B. folgende Zeile enthalten:</para>

<screen>
      gdm auth  sufficient  pam_succeed_if.so  user ingroup nopasswdlogin
</screen>

    </sect2>

    <sect2 id="utmpwtmp">
      <title>utmp und wtmp</title>

      <para>
        GDM generates utmp and wtmp User Accounting Database entries upon
        session login and logout.  The utmp database contains user access
        and accounting information that is accessed by commands such as
        <command>finger</command>, <command>last</command>,
        <command>login</command>, and <command>who</command>.  The wtmp
        database contains the history of user access and accounting 
        information for the utmp database.  Refer to the 
        <ulink type="help" url="man:utmp">utmp</ulink> and
        <ulink type="help" url="man:wtmp">wtmp</ulink>
        man pages on your system for more information.
      </para>
    </sect2>

    <sect2 id="xauth">
      <title>Legitimierungsschema des XServer</title>

      <para>
        Xserver authorization files are stored in a newly created subdirectory
        of <filename>&lt;var&gt;/run/gdm</filename> at start up.  These files
        are used to store and share a "password" between X clients
        and the Xserver.  This "password" is unique for each session
        logged in, so users from one session can't snoop on users from another.
      </para>

      <para>GDM unterstützt nur das Legitimierungsschema »MIT-MAGIC-COOKIE-1« des Xserver. Normalerweise ist der Mehrwert anderer Schemata gering. Daher wurden bisher keine Anstrengungen unternommen, sie zu implementieren. Seien Sie beim Einsatz von XDMCP vorsichtig, weil der Xserver Legitimations-Cookie unverschlüsselt gesendet wird. Falls ein Mithören möglich ist, kann ein Angreifer das Legitimationspasswort während der Anmeldung unabhängig vom verwendeten Schema erspähen. Wenn ein Belauschen möglich, aber unerwünscht ist, dann sollte eine X-Verbindung getunnelt werden, anstatt dem XDMCP einzusetzen. Sie können sich XDMCP als eine Art grafisches Telnet mit den gleichen Sicherheitsproblemen vorstellen. In dem meisten Fällen sollte »ssh -Y« dem Leistungsmerkmal XDMCP vorgezogen werden.</para>

    </sect2>

    <sect2 id="xdmcpsecurity">
      <title>XDMCP-Sicherheit</title>

      <para>Obwohl Ihre Anzeige durch Cookies geschützt wird, werden XEvents und damit auch Tastatureingaben von Passwörtern unverschlüsselt versendet. Sie können sehr leicht belauscht werden.</para>

      <para>XDMCP ist vorrangig nützlich zum Betreiben von Thin Clients an Terminal-Servern. Diese Thin Clients benötigen lediglich ein Netzwerk, um auf den Server zugreifen zu können. Daher scheint es die sicherheitstechnisch beste Lösung zu sein, die Thin Clients in einem separaten Netzwerk zu belassen, das keine Verbindung zur Außenwelt hat und sich nur mit dem Server verbinden kann. Der einzige Zugangspunkt nach außen ist der Server. In dieser Art der Konfiguration gibt es keinen unverwalteten Hub oder ein anderes ausspähbares Netzwerk.</para>

    </sect2>

    <sect2 id="xdmcpaccess">
      <title>XDMCP-Zugangskontrolle</title>

      <para>Die XDMCP-Zugangskontrolle geschieht mittels TCP-Wrappern. Es ist möglich, GDM ohne Unterstützung für TCP-Wrapper zu konfigurieren, sodass diese Funktion auf manchen Betriebssystemen vielleicht nicht unterstützt wird.</para>

      <para>
        You should use the daemon name <command>gdm</command> in the
        <filename>&lt;etc&gt;/hosts.allow</filename> and
        <filename>&lt;etc&gt;/hosts.deny</filename> files.  For example to 
        deny computers from <filename>.evil.domain</filename> from logging in,
        then add
      </para>
<screen>
gdm: .evil.domain
</screen>
      <para>
        to <filename>&lt;etc&gt;/hosts.deny</filename>.  You may also need
        to add
      </para>
<screen>
gdm: .your.domain
</screen>
      <para>
        to your <filename>&lt;etc&gt;/hosts.allow</filename> if you normally
        disallow all services from all hosts.  See the
        <ulink type="help" url="man:hosts.allow">hosts.allow(5)</ulink> man
        page for details.
      </para>
    </sect2>

    <sect2 id="firewall">
      <title>Firewall-Sicherheit</title>

      <para>Obwohl GDM bemüht ist, mögliche Angreifer auf XDMCP auszutricksen, ist es dennoch ratsam, dass der XDMCP-Port (normalerweise UDP Port 177) durch Ihre Firewall geblockt wird, falls Sie es nicht unbedingt benötigen. GDM schützt vor verteilten Überlastungsangriffen, aber das X-Protokoll ist von Natur aus unsicher und sollte nur in sicheren Umgebungen verwendet werden. Ebenfalls werden durch jede entfernte Verbindung viele Systemressourcen belegt, was einen Überlastungsangriff mittels XDMCP leichter macht als gegen einen Webserver.</para>

      <para>Es ist ratsam, alle Ports des XServer zu blockieren. Das sind die TCP-Ports 6000+ (einer für jede Anzeige) auf Ihrer Firewall. Bedenken Sie, dass GDM die Anzeigennummern 20 und höhere für die flexiblen Bedarfsserver verwendet.</para>

      <para>X ist kein besonders sicheres Protokoll im Netz, und XDMCP ist sogar noch unsicherer.</para>
    </sect2>

    <sect2 id="policykit">
      <title>PolicyKit</title>

<!--
<para>
        TODO - Should we say more?
</para>
-->

      <para>GDM kann so konfiguriert werden, das PolicyKit verwendet wird. Dies ermöglicht dem Systemverwalter die Entscheidung darüber, ob der Anmeldebildschirm die Knöpfe zum Ausschalten und Neustart des Rechners im Begrüßer anzeigen soll oder nicht.</para>

      <para>
        These buttons are controlled by the
        <filename>org.freedesktop.consolekit.system.stop-multiple-users</filename>
        and
        <filename>org.freedesktop.consolekit.system.restart-multiple-users</filename>
        actions respectively.  Policy for these actions can be set up using the
        polkit-gnome-authorization tool, or the polkit-auth command line program.
      </para>
 
    </sect2>

    <sect2 id="rbac">
      <title>RBAC (Role Based Access Control)</title>

      <para>GDM kann so konfiguriert werden, dass RBAC anstelle von PolicyKit verwendet wird. In diesem Fall wird die RBAC-Konfiguration verwendet, um festzulegen, ob im Begrüßungsbildschirm die Knöpfe für Herunterfahren und Neustart angezeigt werden.</para>

      <para>
        For example, on Oracle Solaris, the "solaris.system.shutdown"
        authorization is used to control this.  Simply modify the 
        <filename>/etc/user_attr</filename> file so that the "gdm"
        user has this authorization.
      </para>
    </sect2>

  </sect1>

  <!-- ============= ConsoleKit ================================ -->

  <sect1 id="consolekit">
    <title>Unterstützung für ConsoleKit</title>

<!--
<para>
    TODO - Should we update these docs?  Probably should mention any 
           configuration that users may want to do for using it with GDM?
           If so, perhaps this section should be moved to a subsection of
           the "Configure" section?
</para>
-->

    <para>GDM unterstützt das Veröffentlichen von Benutzerkontoinformationen mit dem Framework Consolekit. ConsoleKit ermöglicht die Mitverfolgung aller angemeldeter Benutzer. In dieser Hinsicht kann es als Ersatz für utmp- und utmpx-Dateien verwendet werden, die auf den meisten Unix-Betriebssystemen zur Verfügung stehen.</para>

    <para>Wenn GDM einen neuen Anmeldeprozess für einen Benutzer erstellt ruft es eine privilegierte Methode von ConsoleKit auf, um eine neue Sitzung für den Benutzer zu öffnen. Zu diesem Zeitpunkt liefert GDM auch Informationen über die Benutzersitzung an ConsoleKit wie z.B.: Die Benutzerkennung, der Name der X11-Anzeige der zugehörigen Sitzung, der Rechnername, auf dem die Sitzung läuft (nützlich bei XDMCP-Sitzungen), ob die Sitzung angebunden ist usw. GDM ist als die Instanz, die den Benutzerprozess startet, in einer einzigartigen Lage über alle Vorgänge zu wissen und ihm wird vertraut, die Informationen über die Sitzung geben zu können. Der Gebrauch der privilegierten Methode wird durch die Richtlinien des System-Nachrichtenbus D-Bus eingeschränkt.</para>

    <para>Wenn sich ein Benutzer mit einer bereits bestehenden Sitzung bei GDM authentifiziert hat und die Sitzung fortsetzen möchte, dann wird von GDM eine privilegierte Methode von ConsoleKit zum Entsperren der Sitzung aufgerufen. Die genauen Details was passiert, wenn die Sitzung das Signal zum Entsperren erhält, sind nicht festgelegt und von der Sitzung abhängig. Allerdings werden die meisten Sitzungen darauf hin den Bildschirmschoner entsperren.</para>

    <para>Wenn sich der Benutzer abmeldet oder GDM oder die Sitzung unerwartet beendet wird, so wird die ConsoleKit-Registrierung der Sitzung gelöscht.</para>
  </sect1>

  <!-- ============= Configuration ============================= -->

  <sect1 id="configuration">
    <title>Konfiguration</title>

    <para>GDM verfügt über eine Reihe von Konfigurationsschnittstellen. Diese beinhalten Integrationspunkte für Skripte, die Daemon-Konfiguration, die Begrüßer-Konfiguration, allgemeine Sitzungseinstellungen, die Einbindung der Konfiguration des »gnome-settings-daemon« und die Sitzungskonfiguration. All diese Konfigurationsarten werden nachfolgend detailliert beschrieben.</para>

    <sect2 id="scripting">
      <title>Skripting-Integrationspunkte</title>
      
      <para>
        The GDM script integration points can be found in the
        <filename>&lt;etc&gt;/gdm/</filename> directory:
      </para>

<screen>
Xsession
Init/
PostLogin/
PreSession/
PostSession/
</screen>

      <para>
        The <filename>Init</filename>, <filename>PostLogin</filename>,
        <filename>PreSession</filename>, and <filename>PostSession</filename>
        scripts all work as described below.
      </para>

      <para>
        For each type of script, the default one which will be executed is
        called "Default" and is stored in a directory associated with
        the script type.  So the default <filename>Init</filename> script is 
        <filename>&lt;etc&gt;/gdm/Init/Default</filename>.  A per-display
        script can be provided, and if it exists it will be run instead of the 
        default script.  Such scripts are stored in the same directory as the
        default script and have the same name as the Xserver DISPLAY value for
        that display.  For example, if the <filename>&lt;Init&gt;/:0</filename>
        script exists, it will be run for DISPLAY ":0".
     </para>

     <para>Alle diese mit Systemverwalterrechten ausgeführten Skripte geben den Wert 0 zurück, falls die Ausführung erfolgreich war. Falls ein Fehler auftrat, der zum Abbruch der Anmeldesitzung führte, wird ein von 0 verschiedener Wert zurückgegeben. Beachten Sie auch, dass GDM bis zum Beenden der Skripte blockiert ist. Wenn eines dieser Skripte hängt, dann bleibt der Anmeldevorgang ebenfalls hängen.</para>

      <para>
        When the Xserver for the login GUI has been successfully started, but
        before the login GUI is actually displayed, GDM will run the
        <filename>Init</filename> script.  This script is useful for starting
        programs that should be run while the login screen is showing, or for
        doing any special initialization if required.
      </para>

      <para>
        After the user has been successfully authenticated GDM will run the
        <filename>PostLogin</filename> script.  This is done before any session
        setup has been done, including before the pam_open_session call.  This
        script is useful for doing any session initialization that needs to
        happen before the session starts.  For example, you might setup the
        user's $HOME directory if needed.
      </para>

      <para>
        After the user session has been initialized, GDM will run the
        <filename>PreSession</filename> script.  This script is useful for
        doing any session initialization that needs to happen after the 
        session has been initialized.  It can be used for session management or
        accounting, for example.
      </para>

      <para> 
        When a user terminates their session, GDM will run the
        <filename>PostSession</filename> script.  Note that the Xserver will
        have been stopped by the time this script is run, so it should not be
        accessed.  
      </para>

      <para>
        Note that the <filename>PostSession</filename> script will be run
        even when the display fails to respond due to an I/O error or
        similar. Thus, there is no guarantee that X applications will work
        during script execution.
      </para>

      <para>
        All of the above scripts will set the
        <filename>$RUNNING_UNDER_GDM</filename> environment variable to
        <filename>yes</filename>.  If the scripts are also shared with other
        display managers, this allows you to identify when GDM is calling these
        scripts, so you can run specific code when GDM is used.
      </para>
    </sect2>

    <sect2 id="autostart">
      <title>Autostart-Einstellungen</title>
      
      <para>
        The <filename>&lt;share&gt;/gdm/autostart/LoginWindow</filename>
        directory contains files in the format specified by the
        "FreeDesktop.org Desktop Application Autostart
        Specification".  Standard features in the specification may be
        used to specify programs that should auto-restart or only be launched
        if a GConf configuration value is set, etc.
      </para>

      <para>
        Any <filename>.desktop</filename> files in this directory will cause
        the associated program to automatically start with the login GUI
        greeter.  By default, GDM is shipped with files which will autostart
        the gdm-simple-greeter login GUI greeter itself, the
        gnome-power-manager application, the gnome-settings-daemon, and the
        metacity window manager.  These programs are needed for the greeter
        program to work.  In addition, desktop files are provided for starting
        various AT programs if the configuration values specified in the
        Accessibility Configuration section below are set.
      </para>
    </sect2>

    <sect2 id="xsessionscript">
      <title>Xsession-Skript</title>

      <para>
        There is also an <filename>Xsession</filename> script located at
        <filename>&lt;etc&gt;/gdm/Xsession</filename> which is called between
        the <filename>PreSession</filename> and the
        <filename>PostSession</filename> scripts.  This script does not
        support per-display like the other scripts.  This script is used for
        actually starting the user session.  This script is run as the user,
        and it will run whatever session was specified by the Desktop session
        file the user selected to start. 
      </para>
    </sect2>

    <sect2 id="daemonconfig">
      <title>Daemon-Konfiguration</title>

      <para>
        The GDM daemon is configured using the
        <filename>&lt;etc&gt;/gdm/custom.conf</filename> file.  Default
        values are stored in GConf in the <filename>gdm.schemas</filename>
        file.  It is recommended that end-users modify the
        <filename>&lt;etc&gt;/gdm/custom.conf</filename> file because the
        schemas file may be overwritten when the user updates their system to
        have a newer version of GDM.
      </para>

      <para>Beachten Sie, dass ältere Versionen von GDM zusätzliche Einstellungsoptionen unterstützen, die in neueren GDM-Versionen nicht mehr verfügbar sind.</para>

      <para>
        The <filename>&lt;etc&gt;/gdm/custom.conf</filename> file is in the
        <filename>keyfile</filename> format.  Keywords in brackets
        define group sections, strings before an equal sign (=) are keys and
        the data after equal sign represents their value.  Empty lines or
        lines starting with the hash mark (#) are ignored.  
      </para>

      <para>
        The file <filename>&lt;etc&gt;/gdm/custom.conf</filename> supports the
        "[daemon]", "[security]", and "[xdmcp]"
        group sections.  Within each group, there are particular key/value
        pairs that can be specified to modify how GDM behaves.  For example,
        to enable timed login and specify the timed login user to be a user
        named "you", you would modify the file so it contains the
        following lines:
      </para>
     
<screen>
[daemon]
TimedLoginEnable=true
TimedLogin=you
</screen>

      <para>Es folgt die vollständige Liste unterstützter Konfigurationsschlüssel:</para>

      <sect3 id="choosersection">
        <title>[chooser]</title>
        <variablelist>

          <varlistentry>
            <term>Multicast</term>
            <listitem>
              <synopsis>Multicast=false</synopsis>
              <para>Falls wahr und IPv6 aktiviert ist, so sendet der Wähler Multicast-Anfragen ins lokale Netzwerk und sammelt Antworten von den Rechnern, die der Multicast-Gruppe beigetreten sind.</para>
            </listitem>
          </varlistentry>
         
          <varlistentry>
            <term>MulticastAddr</term>
            <listitem>
              <synopsis>MulticastAddr=ff02::1</synopsis>
              <para>Dies ist die Link-Local Multicast-Adresse.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="daemonsection">
        <title>[daemon]</title>
        <variablelist>
          <varlistentry>
            <term>TimedLoginEnable</term>
            <listitem>
              <synopsis>TimedLoginEnable=false</synopsis>
              <para>
                 If the user given in <filename>TimedLogin</filename> should be
                logged in after a number of seconds (set with
                <filename>TimedLoginDelay</filename>) of inactivity on the
                login screen.  This is useful for public access terminals or
                perhaps even home use.  If the user uses the keyboard or
                browses the menus, the timeout will be reset to 
                <filename>TimedLoginDelay</filename> or 30 seconds, whichever 
                is higher.   If the user does not enter a username but just
                hits the ENTER key while the login program is requesting the
                username, then GDM will assume the user wants to login
                immediately as the timed user.  Note that no password will be
                asked for this user so you should be careful, although if using
                PAM it can be configured to require password entry before
                allowing login.  Refer to the "Security-&gt;PAM"
                section of the manual for more information, or for help if this
                feature does not seem to work.
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>TimedLogin</term>
            <listitem>
              <synopsis>TimedLogin=</synopsis>
              <para>Dieser Benutzer wird nach einer bestimmten Anzahl inaktiver Sekunden automatisch angemeldet.</para>
              <para>Wenn der Wert mit einem senkrechten Strich »|« (Unix-Umleitung) endet, dann wird GDM das angegebene Programm ausführen und die Standardausgabe des Programms als Benutzernamen verwenden. Das Programm wird mit gesetzter Variable »DISPLAY« ausgeführt, sodass es möglich ist, je nach Anzeige einen anderen Benutzer zu haben. Zum Beispiel für den Fall, dass der Wert »/usr/bin/getloginuser|« ist, wird das Programm »/usr/bin/getloginuser« ausgeführt, um den Benutzer zu ermitteln.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>TimedLoginDelay</term>
            <listitem>
              <synopsis>TimedLoginDelay=30</synopsis>
              <para>
                Delay in seconds before the <filename>TimedLogin</filename>
                user will be logged in.
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>AutomaticLoginEnable</term>
            <listitem>
              <synopsis>AutomaticLoginEnable=false</synopsis>
              <para>
                If true, the user given in <filename>AutomaticLogin</filename>
                should be logged in immediately. This feature is like timed
                login with a delay of 0 seconds.
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>AutomaticLogin</term>
            <listitem>
              <synopsis>AutomaticLogin=</synopsis>
              <para>
                This is the user that should be logged in immediately if
                <filename>AutomaticLoginEnable</filename> is true.
              </para>
              <para>Wenn der Wert mit einem senkrechten Strich »|« (Unix-Umleitung) endet, dann wird GDM das angegebene Programm ausführen und die Standardausgabe des Programms als Benutzernamen verwenden. Das Programm wird mit gesetzter Variable »DISPLAY« ausgeführt, sodass es möglich ist, je nach Anzeige einen anderen Benutzer zu haben. Zum Beispiel für den Fall, dass der Wert »/usr/bin/getloginuser|« ist, wird das Programm »/usr/bin/getloginuser« ausgeführt, um den Benutzer zu ermitteln.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>User</term>
            <listitem>
              <synopsis>User=gdm</synopsis>
              <para>
                The username under which the greeter and other GUI programs
                are run.  Refer to the <filename>User</filename>
                configuration key and to the "Security-&gt;GDM User And
                Group" section of this document for more information.
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Group</term>
            <listitem>
              <synopsis>Group=gdm</synopsis>
              <para>
                The group name under which the greeter and other GUI programs
                are run.  Refer to the <filename>Group</filename>
                configuration key and to the "Security-&gt;GDM User And
                Group" section of this document for more information.
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="debugsection">
        <title>Optionen zur Fehlerdiagnose</title>
      
        <variablelist>
          <title>[debug]</title>
          
          <varlistentry>
            <term>Enable</term>
            <listitem>
              <synopsis>Enable=false</synopsis>
              <para>
                To enable debugging, set the debug/Enable key to
                "true" in the
                <filename>&lt;etc&gt;/gdm/custom.conf</filename>
                file and restart GDM.  Then debug output will be sent to the
                system log file (<filename>&lt;var&gt;/log/messages</filename>
                or <filename>&lt;var&gt;/adm/messages</filename> depending on
                your Operating System).
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="securitysection">
        <title>Sicherheitsoptionen</title>
      
        <variablelist>
          <title>[security]</title>
          
          <varlistentry>
            <term>DisallowTCP</term>
            <listitem>
              <synopsis>DisallowTCP=true</synopsis>
              <para>
                If true, then always append <filename>-nolisten tcp</filename>
                to the command line when starting attached Xservers, thus
                disallowing TCP connection.  This is a more secure
                configuration if you are not using remote connections.
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="xdmcpsection">
        <title>XDMCP-Unterstützung</title>

        <variablelist>
          <title>[xdmcp]</title>
          
          <varlistentry>
            <term>DisplaysPerHost</term>
            <listitem>
              <synopsis>DisplaysPerHost=1</synopsis>
              <para>Um Angriffe durch Füllen der Warteschlange zu verhindern, erlaubt GDM nur eine Verbindung für jeden entfernten Rechner. Wenn Sie Anzeigedienste für Rechner mit mehr als einem Bildschirm bereitstellen möchten, sollten Sie diesen Wert entsprechend erhöhen.</para>

              <para>Beachten Sie, dass die Anzahl erlaubter angebundener Anzeigen nicht beschränkt ist. Nur entfernte Verbindungen mittels XDMCP werden durch diese Option beschränkt.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Enable</term>
            <listitem>
              <synopsis>Enable=false</synopsis>
              <para>Legt fest, ob Unterstützung für XDMCP aktiviert wird, sodass entfernte Anzeigen/X-Terminals durch GDM verwaltet werden.</para>
            
              <para>
                <filename>gdm</filename> listens for requests on UDP port 177.
                See the Port option for more information.
              </para>
              
              <para>
                If GDM is compiled to support it, access from remote displays
                can be controlled using the TCP Wrappers library. The service
                name is <filename>gdm</filename>
              </para>
            
              <para>
                You should add 
<screen>
gdm:.my.domain
</screen>
                to your <filename>&lt;etc&gt;/hosts.allow</filename>, depending
                on your TCP Wrappers configuration.  See the
                <ulink type="help" url="man:hosts.allow">hosts.allow</ulink>
                man page for details.
              </para>
              
              <para>Bitte beachten Sie, dass XDMCP kein ausgesprochen sicheres Protokoll ist. Es könnte daher eine gute Idee sein, in Ihrer Firewall-Konfiguration den UDP-Port 177 zu blockieren, falls Sie ihn nicht wirklich unbedingt brauchen.</para>
            </listitem>
          </varlistentry>
          
          <varlistentry>
            <term>HonorIndirect</term>
            <listitem>
              <synopsis>HonorIndirect=true</synopsis>
              <para>
                Enables XDMCP INDIRECT choosing (i.e. remote execution of
                <filename>gdmchooser</filename>) for X-terminals which do not
                supply their own display browser.
              </para>
            </listitem>
          </varlistentry>
        
          <varlistentry>
            <term>MaxPending</term>
            <listitem>
              <synopsis>MaxPending=4</synopsis>
              <para>Zur Vermeidung von massiven Überlastungsangriffen besitzt GDM eine Warteschlange fester Länge von ausstehenden Verbindungen. Es können höchstens so viele Anzeigen gleichzeitig gestartet werden, wie in »MaxPending« angegeben ist.</para>
            
              <para>Bitte beachten Sie, dass dieser Parameter nicht die Anzahl der verwaltbaren entfernten Displays begrenzt, sondern lediglich die Anzahl der Displays, die eine Verbindung gleichzeitig initiieren.</para>
            </listitem>
          </varlistentry>
          
          <varlistentry>
            <term>MaxSessions</term>
            <listitem>
              <synopsis>MaxSessions=16</synopsis>
              <para>Bestimmt die maximale Anzahl Verbindungen zu entfernten Displays, die gleichzeitig verwaltet werden. Anders ausgedrückt, die Gesamtzahl entfernter Displays, die Ihr Rechner nutzen kann.</para>
            </listitem>
          </varlistentry>
        
          <varlistentry>
            <term>MaxWait</term>
            <listitem>
              <synopsis>MaxWait=30</synopsis>
              <para>Wenn GDM zur Verwaltung einer Anzeige bereit ist , wird an diese ein »ACCEPT«-Paket mit einer eindeutigen Sitzungskennung gesendet, die bei weiterer Kommunikation verwendet wird.</para>
            
              <para>GDM wird dann die Sitzungskennung in die Liste ausstehender Verbindungen einfügen und auf eine »MANAGE«-Anfrage als Antwort der Anzeige warten.</para>
            
              <para>Wenn keine Antwort innerhalb »MaxWait« Sekunden empfangen wird, dann wird GDM die Anzeige als verschwunden ansehen und den Eintrag aus der Liste ausstehender Verbindungen entfernen und einen freien Platz für eine andere Anzeige schaffen.</para>
            </listitem>
          </varlistentry>
          
          <varlistentry>
            <term>MaxWaitIndirect</term>
            <listitem>
              <synopsis>MaxWaitIndirect=30</synopsis>
              <para>
                The MaxWaitIndirect parameter determines the maximum number of
                seconds between the time where a user chooses a host and the
                subsequent indirect query where the user is connected to the
                host.  When the timeout is exceeded, the information about the
                chosen host is forgotten and the indirect slot freed up for
                other displays.  The information may be forgotten earlier if
                there are more hosts trying to send indirect queries then
                <filename>MaxPendingIndirect</filename>.
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Port</term>
            <listitem>
              <synopsis>Port=177</synopsis>
              <para>
                The UDP port number <filename>gdm</filename> should listen to
                for XDMCP requests. Do not change this unless you know what
                you are doing.
              </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Willing</term>
            <listitem>
              <synopsis>Willing=&lt;etc&gt;/gdm/Xwilling</synopsis>
              <para>Wenn der Rechner ein »WILLING«-Paket nach einem »QUERY« zurücksendet, so wird eine Zeichenkette gesendet, die den aktuellen Status des Server vermittelt. Die vorgegebene Nachricht ist die Systemkennung, aber es ist möglich ein Skript zu erstellen, das angepasste Nachrichten anzeigen lässt. Wenn das Skript nicht vorhanden ist oder der Schlüssel leer ist, so wird die Vorgabenachricht gesendet. Wenn das Skript existiert und eine Ausgabe zurückgibt, dann wird (nur) die erste Zeile der Ausgabe gesendet. Es wird höchstens alle 3 Sekunden ausgeführt, um eine möglich Überlastung des Rechners durch eine Flut von »QUERY«-Paketen zu verhindern.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>
    </sect2>

    <sect2 id="greeterconfiguration">
        <title>Einfache Konfiguration des Begrüßers</title>

        <para>
          The GDM default greeter is called the simple Greeter and is
          configured via GConf.  Default values are stored in GConf in the
          <filename>gdm-simple-greeter.schemas</filename> file.  These defaults
          can be overridden if the "gdm" user has a writable $HOME
          directory to store GConf settings.  These values can be edited using
          the <command>gconftool-2</command> or <command>gconf-editor</command>
          programs.  The following configuration options are supported:
        </para>

        <variablelist>
          <title>Konfigurationsschlüssel für den Begrüßer</title>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/banner_message_enable</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob die Bannernachricht angezeigt wird.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/banner_message_text</term>
            <listitem>
              <synopsis>NULL (Zeichenkette)</synopsis>
              <para>Legt die Textnachricht im Banner des Begrüßerfensters fest.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/disable_restart_buttons</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob die Knöpfe für den Neustart im Anmeldefenster angezeigt werden.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/disable_user_list</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob das Benutzeralbum mit bekannten Benutzern nicht im Anmeldefenster angezeigt wird.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/logo_icon_name</term>
            <listitem>
              <synopsis>computer (Zeichenkette)</synopsis>
              <para>Legt den Symbolnamen des Themas für das Logo im Begrüßer fest.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/recent-languages</term>
            <listitem>
              <synopsis>[] (Liste aus Zeichenketten)</synopsis>
              <para>Legt die Liste aller Sprachen fest, die als Voreinstellung im Anmeldefenster angezeigt werden. Der Vorgabewert ist »[]«. Mit dem Vorgabewert wird nur die systemweit voreingestellte Sprache angezeigt und die Option »Weitere …«, die ein Dialogfenster mit allen verfügbaren Sprachen zum Auswählen einblendet.</para>

              <para>Benutzer sollten diese Einstellung nicht manuell ändern. GDM merkt sich die gewählten Sprachen in diesem Konfigurationsschlüssel und sie werden im Auswahlfeld zusammen mit den Sprachen aus dem Dialogfeld »Weitere …« angezeigt. Auf diese Weise können oft gewählte Sprachen leichter ausgewählt werden.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/recent-layouts</term>
            <listitem>
              <synopsis>[] (Liste aus Zeichenketten)</synopsis>
              <para>Legt die voreingestellte Liste der im Panel angezeigten Tastaturbelegungen fest. Mit dem Vorgabewert wird nur die systemweit voreingestellte Tastaturbelegung angezeigt und die Option »Weitere …«, die ein Dialogfenster mit allen verfügbaren Belegungen zum Auswählen einblendet.</para>

              <para>Benutzer sollten diese Einstellung nicht manuell ändern. GDM merkt sich die gewählten Tastaturbelegungen in diesem Konfigurationsschlüssel und sie werden im Auswahlfeld zusammen mit den Belegungen aus dem Dialogfeld »Weitere …« angezeigt. Auf diese Weise können oft gewählte Tastaturbelegungen leicht ausgewählt werden.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>/apps/gdm/simple-greeter/wm_use_compiz</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob Compiz als Fenstermanager anstelle von Metacity verwendet wird.</para>
            </listitem>
          </varlistentry>
        </variablelist>
    </sect2>

    <sect2 id="accessibilityconfiguration">
     <title>Konfiguration der Barrierefreiheit</title>

      <para>Dieser Abschnitt beschreibt die Konfiguration der Einstellungen der Barrierefreiheit in GDM.</para>

      <sect3 id="accessibilitydialog">
        <title>GDM-Dialog zur Barrierefreiheit und GConf-Schlüssel</title>

        <para>Das Begrüßer-Panel von GDM zeigt im Anmeldebildschirm ein Barrierefreiheits-Symbol. Ein Klick auf das Symbol öffnet den Dialog der GDM-Barrierefreiheit. Im Dialog gibt es eine Liste von Ankreuzfeldern zum Aktivieren und Deaktivieren verschiedener Hilfstechnologien.</para>

        <para>Die Ankreuzfelder für die Hilfswerkzeuge Bildschirmtastatur, Bildschirmlupe und Bildschirmleser wirken sich auf drei GConf-Schlüssel aus, die im nächsten Abschnitt der Hilfeseite beschrieben werden. Durch Auswählen der Ankreuzfelder wird der entsprechende GConf-Schlüssel auf »wahr« oder »falsch« eingestellt. Wenn der GConf-Schlüssel auf wahr gesetzt ist, werden die mit diesem Schlüssel verknüpften Hilfswerkzeuge gestartet. Wenn der GConf-Schlüssel auf falsch gesetzt ist, werden alle mit diesem Schlüssel verknüpften Hilfswerkzeuge beendet. Diese Schlüssel werden nicht automatisch auf eine Voreinstellung zurückgesetzt, nachdem sich ein Benutzer angemeldet hat. Das bedeutet, dass die aktiven Hilfstechnologien der letzten GDM-Sitzung auch automatisch in folgenden Sitzungen gestartet werden.</para>

        <para>Die anderen Ankreuzfelder im GDM-Dialog zur Barrierefreiheit haben keine zugeordneten GConf-Schlüssel, weil kein zusätzliches Programm zur Aktivierung der Merkmale gestartet werden muss. Sie entsprechen Merkmalen der Barrierefreiheit, die vom Xserver bedient werden können, der immer während einer GDM-Sitzung läuft.</para>
      </sect3>

      <sect3 id="accessibilitygconfconfiguration">
        <title>GConf-Schlüssel der Barrierefreiheit</title>

        <para>GDM bietet die folgenden GConf-Schlüssel zur Steuerung der Barrierefreiheit:</para>

        <variablelist>
          <title>Konfigurationsschlüssel von GDM</title>

          <varlistentry>
            <term>/desktop/gnome/interface/accessibility</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob die Barrierefreiheits-Infrastruktur zusammen mit der GDM-Benutzeroberfläche gestartet werden soll. Dies ist für die Funktion von Barrierefreiheits-Anwendungen notwendig.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>/desktop/gnome/applications/at/screen_magnifier_enabled</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob die mit diesem GConf-Schlüssel verknüpften Hilfstechnologien mit der GDM-Oberfläche gestartet werden. Die Voreinstellung ist eine Bildschirmlupe.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>/desktop/gnome/applications/at/screen_keyboard_enabled</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob die mit diesem GConf-Schlüssel verknüpften Hilfstechnologien mit der GDM-Oberfläche gestartet werden. Die Voreinstellung ist eine Bildschirmtastatur.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>/desktop/gnome/applications/at/screen_reader_enabled</term>
            <listitem>
              <synopsis>falsch (Boolesche Variable)</synopsis>
              <para>Legt fest, ob die mit diesem GConf-Schlüssel verknüpften Hilfstechnologien mit der GDM-Oberfläche gestartet werden. Die Voreinstellung ist ein Bildschirmleser.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="accessibilitytoolsconfiguration">
        <title>GConf-Schlüssel mit Werkzeugen der Barrierefreiheit verknüpfen</title>

        <para>Bei den GConf-Schlüsseln »screen_magnifier_enabled«, »the screen_keyboard_enabled« und »screen_reader_enabled« hängt das Hilfswerkzeug, das gestartet wird, von den .desktop-Dateien im Autostart-Ordner von GDM ab, wie es im Abschnitt »Autostart-Einstellungen« dieses Handbuchs beschrieben wird. Jede .desktop-Datei im Autostart-Ordner von GDM kann mit diesen GConf-Schlüsseln verknüpft werden über den Eintrag »AutostartCondition« in der .desktop-Datei. Eine Zeile mit dem Eintrag »AutostartCondition« könnte genau so aussehen wie eine der Folgenden:</para>

<screen>
AutostartCondition=GNOME /desktop/gnome/applications/at/screen_keyboard_enabled
AutostartCondition=GNOME /desktop/gnome/applications/at/screen_magnifier_enabled
AutostartCondition=GNOME /desktop/gnome/applications/at/screen_reader_enabled
</screen>

        <para>Wenn ein Schlüssel der Barrierefreiheit auf wahr festgelegt ist, dann wird jedes Programm gestartet, dass in einer .desktop-Datei von GDM mit dem Schlüssel verknüpft ist (es sei denn, der Schlüssel ist in einer .desktop-Datei auf »Hidden« (versteckt) gesetzt). Ein einziger GConf-Schlüssel kann sogar mehrere Hilfswerkzeuge starten, wenn mehrere .desktop-Dateien mit diesem Schlüssel »AutostartCondition« im Autostart-Ordner von GDM sind.</para>
      </sect3>

      <sect3 id="accessibilitytoolexample">
        <title>Beispiel zur Bearbeitung der Einstellungen eines Werkzeuges der Barrierefreiheit</title>

        <para>Wenn zum Beispiel GOK in Ihrer GNOME-Version als Bildschirmtastatur voreingestellt ist, dann könnte es durch ein anderes bevorzugtes Programm ersetzt werden. Um GOK durch die Bildschirmtastatur »onboard« zu ersetzen und zusätzlich das Hilfswerkzeug »mousetweaks« zur Unterstützung des verzögerten Klicks zu aktivieren, wird die folgende Konfiguration benötigt.</para>

        <para>Erstellen Sie eine .desktop-Datei für »onboard« und eine zweite für »mousetweaks«, zum Beispiel mit den Namen »onboard.desktop« und »mousetweaks.desktop«. Diese Dateien müssen im Autostart-Ordner von GDM abgelegt werden und im wie in Abschnitt »Autostart-Einstellungen« beschriebenen Format vorliegen.</para>

        <para>
         The following is an example <filename>onboard.desktop</filename> file:
        </para>

<screen>
[Desktop Entry]
Encoding=UTF-8
Name=Onboard Onscreen Keyboard
Comment=Use an on-screen keyboard
TryExec=onboard
Exec=onboard --size 500x180 -x 20 -y 10
Terminal=false
Type=Application
StartupNotify=true
Categories=GNOME;GTK;Accessibility;
AutostartCondition=GNOME /desktop/gnome/applications/at/screen_keyboard_enabled
</screen>

        <para>
         The following is an example <filename>mousetweaks.desktop</filename>
         file:
        </para>

<screen>
[Desktop Entry]
Encoding=UTF-8
Name=Software Mouse-Clicks
Comment=Perform clicks by dwelling with the pointer
TryExec=mousetweaks
Exec=mousetweaks --enable-dwell -m window -c -x 20 -y 240 
Terminal=false
Type=Application
StartupNotify=true
Categories=GNOME;GTK;Accessibility;
AutostartCondition=GNOME /desktop/gnome/applications/at/screen_keyboard_enabled
</screen>

        <para>Beachten Sie die Zeile mit »AutostartCondition«, die beide .desktop-Dateien mit dem GConf-Schlüssel für die Bildschirmtastatur verknüpft.</para>

        <para>Um den Start von GOK zu verhindern, muss die .desktop-Datei für die GOK-Bildschirmtastatur entfernt oder deaktiviert werden. Anderenfalls würden onboard und GOK zugleich gestartet werden. Dies kann durch Löschen der Datei »gok.desktop« aus dem Autostart-Ordner von GDM erzielt werden, oder durch Hinzufügen der Schlüsseleinstellung »Hidden=true« in der Datei »gok.desktop«.</para>

        <para>Nach dem Durchführen diese Änderungen wird GOK nicht mehr gestartet, wenn der Benutzer die Bildschirmtastatur in der GDM-Sitzung aktiviert; jedoch werden stattdessen »onboard« und »mousetweaks« gestartet.</para>
      </sect3>
    </sect2>

    <sect2 id="generalsessionconfig">
      <title>Allgemeine Sitzungseinstellungen</title>
<!--
<para>
          TODO - I think this section should be expanded upon.  What specific
                 keys are of interest, or would some users be likely to want
                 to configure?  Also, would be good to be more specific about
                 how lock down management is handled.
</para>
-->
        <para>Der GDM-Begrüßer verwendet einen Teil des Framework, das Ihre Sitzung verwendet. Einige GConf-Einstellungen werden gemeinsam verwendet. Der Begrüßer verwendet die Vorgabewerte, wenn diese nicht explizit durch a) zwingende GDM-Richtlinien oder b) zwingende Systemrichtlinien überschrieben werden. GDM installiert eine eigene zwingende Richtlinie zum Einschränken des Zugriffs auf einige Sicherheitseinstellungen.</para>
    </sect2>

    <sect2 id="gnomesettingsdaemon">
      <title>GNOME-Einstellungsdaemon</title>
<!--
<para>
          TODO - I think this section should be expanded upon.  What specific
                 keys are of interest, or would some users be likely to want
                 to configure?  Also, would be good to give a more complete
                 list of plugins that users might want to consider disabling.
                 Also, shouldn't we list the sound/active key in the Greeter
                 configuration setting?  Oddly I do not find this key used
                 in anything but the chooser in SVN.
</para>
-->

        <para>GDM aktiviert die folgenden Plugins von gnome-settings-daemon: a11y-keyboard, background, sound, xsettings.</para>

        <para>Diese sind verantwortlich für Dinge wie das Hintergrundbild, die Schrift, die Einstellungen für das Thema, Klänge etc.</para>

        <para>
          Plugins can also be disabled using GConf. For example, if you want to
          disable the sound plugin then unset the following key:
          <filename>/apps/gdm/simple-greeter/settings-manager-plugins/sound/active</filename>.
        </para>
    </sect2>

    <sect2 id="sessionconfig">
      <title>GDM-Sitzungseinstellungen</title>

      <para>
        GDM sessions are specified using the FreeDesktop.org Desktop Entry
        Specification, which can be referenced at the following URL:
        <ulink url="http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec">
        http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec</ulink>.
      </para>

      <para>
        By default, GDM will install desktop files in the
        <filename>&lt;share&gt;/xsessions</filename> directory.  GDM will
        search the following directories in this order to find desktop files:
        <filename>&lt;etc&gt;/X11/sessions/</filename>,
        <filename>&lt;dmconfdir&gt;/Sessions</filename>, 
        <filename>&lt;share&gt;/xsessions</filename>, and
        <filename>&lt;share&gt;/gdm/BuiltInSessions</filename>.  By default the
        <filename>&lt;dmconfdir&gt;</filename> is set to
        <filename>&lt;etc&gt;/dm/</filename> unless GDM is configured to use
        a different directory via the "--with-dmconfdir" option.
      </para>

      <para>
        A session can be disabled by editing the desktop file and adding a line
        as follows: <filename>Hidden=true</filename>.
      </para>

      <para>
        GDM desktop files support a GDM-specific extension, a key named
        "X-GDM-BypassXsession".  If the key is not specified in a
        desktop file, the value defaults to "false".  If this key is
        specified to be "true" in a desktop file, then GDM will
        launch the program specified by the desktop file "Exec" key
        directly when starting the user session.  It will not run the program
        via the <filename>&lt;etc&gt;/gdm/Xsession</filename> script, which is
        the normal behavior.  Since bypassing the
        <filename>&lt;etc&gt;/gdm/Xsession</filename> script avoids setting up
        the user session with the normal system and user settings, sessions
        started this way can be useful for debugging problems in the system or
        user scripts that might be preventing a user from being able to start
        a session.
      </para>

    </sect2>

    <sect2 id="userconfig">
      <title>Konfiguration der GDM-Benutzersitzung und Sprache</title>
      <para>
        The user's default session and language choices are stored in the
        <filename>~/.dmrc</filename> file.  When a user logs in for the first
        time, this file is created with the user's initial choices.  The user
        can change these default values by simply changing to a different value
        when logging in.  GDM will remember this change for subsequent logins.
      </para>

      <para>
        The <filename>~/.dmrc</filename> file is in the standard
        <filename>INI</filename> format.  It has one section called
        <filename>[Desktop]</filename> which has two keys:
        <filename>Session</filename> and <filename>Language</filename>.
      </para>

      <para>
        The <filename>Session</filename> key specifies the basename of the
        session <filename>.desktop</filename> file that the user wishes to
        normally use without the <filename>.desktop</filename> extension.
        The <filename>Language</filename> key specifies the language that the
        user wishes to use by default.  If either of these keys is missing, the
        system default is used.  The file would normally look as follows:
      </para>

<screen>
[Desktop]
Session=gnome
Language=cs_CZ.UTF-8
</screen>
    </sect2>

  </sect1>

  <!-- ============= GDM Commands ============================= -->

  <sect1 id="binaries">
    <title>GDM-Befehle</title>

    <sect2 id="sbindir_binaries">
      <title>GDM-Systemverwalter-Befehle</title>

      <para>
        The GDM package provides the following commands in
        <filename>sbindir</filename> intended to be run by the root user:
      </para>

      <sect3 id="gdmcommandline">
        <title><command>gdm</command> Command Line Options</title>

        <para>
          <command>gdm</command> is the main daemon which sets up
          graphical login environment and starts necessary helpers.
       </para>

        <variablelist>
          <title><command>gdm</command> Command Line Options</title>

          <varlistentry>
            <term>-?, --help</term>
            <listitem>
              <para>Zeigt einen Überblick der Befehlszeilenoptionen an.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>--fatal-warnings</term>
            <listitem>
              <para>Alle Warnungen führen zum Beenden von GDM.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>--timed-exit</term>
            <listitem>
              <para>Abbruch nach 30 Sekunden. Dies ist nützlich für die Fehlerdiagnose.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>--version</term>
            <listitem>
              <para>Zeigt die Version des GDM-Daemons.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>

      <sect3 id="gdmrestartcommandline">
        <title><command>gdm-restart</command> Command Line Options</title>

        <para>
          <command>gdm-restart</command> stops and restarts GDM by sending
          the GDM daemon a HUP signal.  This command will immediately terminate
          all sessions and log out users currently logged in with GDM.
        </para>
      </sect3>

      <sect3 id="gdmsaferestartcommandline">
        <title><command>gdm-safe-restart</command> Command Line Options</title>
  
        <para>
          <command>gdm-safe-restart</command> stops and restarts GDM by
          sending the GDM daemon a USR1 signal.  GDM will be restarted as soon
          as all users log out.
        </para>
      </sect3>

      <sect3 id="gdmstopcommandline">
        <title><command>gdm-stop</command> Command Line Options</title>

        <para>
          <command>gdm-stop</command> stops GDM by sending the GDM daemon
          a TERM signal. 
        </para>
      </sect3>
    </sect2>
  </sect1>

  <!-- ============= Troubleshooting =========================== -->

  <sect1 id="troubleshooting">
    <title>Fehlerbehandlung</title>
<!--
<para>
      TODO - any other tips we should add?  Might be useful to highlight any
             common D-Bus configuration issues?
</para>
-->

    <para>Dieser Abschnitt bietet nützliche Tipps, wie Sie GDM zum Laufen bringen. Allgemein können Sie bei Problemen bei der Benutzung von GDM einen Fehlerbericht einschicken oder eine Nachricht an die Mailingliste »gdm-list« senden. Weitere Informationen finden Sie im Abschnitt »Einführung« dieses Dokuments.</para>

    <para>
      If GDM is failing to work properly, it is always a good idea to include
      debug information.  To enable debugging, set the debug/Enable key to
      "true" in the <filename>&lt;etc&gt;/gdm/custom.conf</filename>
      file and restart GDM.  Then use GDM to the point where it fails, and
      debug output will be sent to the system log file
      (<filename>&lt;var&gt;/log/messages</filename> or
      <filename>&lt;var&gt;/adm/messages</filename> depending on your Operating
      System).  If you share this output with the GDM community via a bug
      report or email, please only include the GDM related debug information
      and not the entire file since it can be large.  If you do not see any
      GDM syslog output, you may need to configure syslog (refer to the
      <ulink type="help" url="man:syslog">syslog</ulink> man page).
    </para>

    <sect2 id="wontstart">
      <title>GDM startet nicht</title>

      <para>Es gibt viele Probleme, die GDM am Starten hindern können. In diesem Abschnitt werden einige allgemeine Probleme behandelt, sowie die Möglichkeiten, wie man den Gründen für diese Startprobleme auf die Spur kommen kann. In einigen Fällen meldet sich GDM bei einem missglückten Startversuch mit einer Fehlermeldung zu Wort. Wenn der GDM-Start allerdings ohne Fehlermeldung abgebrochen wird, kann die Problemsuche schwierig werden.</para>

      <para>Zunächst stellen Sie bitte sicher, dass der X-Server sauber konfiguriert ist. Die GDM-Konfigurationsdatei enthält einen Befehl im Abschnitt [server-Standard], der für den Start des X-Servers verwendet wird. Stellen sie sicher, dass dieser Befehl auf Ihrem System funktioniert. Wenn Sie diesen Befehl in einer Textkonsole ausführen, sollte der X-Server starten. Falls der Start scheitert, liegt das Problem möglicherweise in der Konfiguration Ihres X-Servers. Ziehen Sie die X-Server-Logdatei zu Rate, um festzustellen, wo das Problem liegen könnte. Es könnte beispielsweise sein, dass der X-Server abweichende Befehlszeilenoptionen benötigt. In diesem Fall ändern Sie bitte bitte den X-Server-Befehl in der GDM-Konfigurationsdatei so ab, wie es Ihr System erfordert.</para>

      <para>
         Also make sure that the <filename>/tmp</filename> directory has
         reasonable ownership and permissions, and that the machine's file
         system is not full.  These problems will cause GDM to fail to start.
      </para>
    </sect2>
  </sect1>

  <!-- ============= Application License ============================= -->

  <sect1 id="license">
    <title>Lizenz</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>51 Franklin Street, Fifth Floor</street>
      <city>Boston</city>, <state>MA</state> <postcode>02110-1301</postcode>
      <country>USA</country>
      </address>
    </para>
  </sect1>
</article>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
