# Les fichiers de configuration de &kdm;

Ce chapitre documente les fichiers qui contrôlent les fonctionnalités de &kdm;. Certaines de ces fonctionnalités peuvent également être définies depuis le module &kcontrol;.

## Fichier de configuration principal de &kdm;

Le format basique du fichier est de type INI.

Les lignes commençant par un `#` sont des commentaires; les lignes vides sont simplement ignorées.

Les sections sont dénotées par `[``Nom de la Section``]`.

Vous pouvez configurer chaque affichage X individuellement.

Chaque affichage a un nom, qui consiste en un nom d'hôte (qui est vide pour les affichages locaux spécifiés dans `StaticServers` ou `ReserveServers`), un caractère « : » et un numéro d'affichage. De plus, un affichage appartient à une classe d'affichage (qui peut être ignorée dans la plupart des cas).

Les sections avec des paramètres spécifiques à un affichage ont la syntaxe formelle `[X-` `host` [ `:` `number` [ `_` `class` ] ] `-` `sub-section` `]`

Toutes les sections avec le même `sub-section` constituent une classe de section.

Vous pouvez utiliser le caractère joker `*` (n'importe quelle correspondance) pour `host`, `number` et `class`. Vous pouvez omettre des choses en fin de ligne, elles seront alors considérées comme étant *. La partie concernant l'hôte peut être une spécification de domaine comme `.inf.tu-dresden.de` ou le caractère joker `+` (correspondance pour ce qui est non-vide).

La section depuis laquelle la configuration est extraite est déterminée par ces règles :

- Une correspondance exacte est prioritaire sur une correspondance partielle (pour la partie hôte), qui à son tour est prioritaire sur un caractère joker (`+` est prioritaire sur `*`).

- La priorité décroît de gauche à droite pour des correspondances exactes identiques.

- Exemple : le nom d'affichage myhost.foo:0, classe dpy

  - [X-myhost.foo:0_dpy] est prioritaire sur

  - [X-myhost.foo:0_*] (identique à [X-myhost.foo:0]) est prioritaire sur

  - [X-myhost.foo:*_dpy] est prioritaire sur

  - [X-myhost.foo:*_*] (identique à [X-myhost.foo]) est prioritaire sur

  - [X-.foo:*_*] (identique à [X-.foo]) est prioritaire sur

  - [X-+:0_dpy] est prioritaire sur

  - [X-*:0_dpy] est prioritaire sur

  - [X-*:0_*] (identique à [X-*:0]) est prioritaire sur

  - [X-*:*_*] (identique à [X-*]).

  - Ces sections ne correspondent pas à cet affichage :

    [X-hishost], [X-myhost.foo:0_dec], [X-*:1], [X-:*]

Les sections communes sont [X-*] (tous les affichages), [X-:*] (tous les affichages locaux) et [X-:0] (le premier affichage local).

Le format pour toutes les clés est ```clé`` `=` `valeur``. Les clés ne sont valides que dans la classe de section pour laquelle elles ont été définies. Certaines clés ne s'apliquent pas à certains affichages, auquel cas elles sont ignorées.

Si un réglage n'est trouvé dans aucune section, la valeur par défaut est utilisée.

Les caractères spéciaux doivent être échappés par le caractère « antislash » (espaces de début et de fin(`\s`), tabulation (`\t`), fin de ligne (`\n`), retour chariot (`\r`) et le caractère « antislash » lui-même (`\\`)).

Dans les listes, les champs sont séparés par des virgules et n'ont pas d'espace entre eux.

Some command strings are subject to simplified sh-style word splitting: single quotes (`'`) and double quotes (`"`) have the usual meaning; the backslash quotes everything (not only special characters). Note that the backslashes need to be doubled because of the two levels of quoting.

Un fichier &kdmrc; primitif est commenté en détail. Tous les commentaires seront perdus si vous modifiez ce fichier via l'interface kcontrol.

### La section [General] de &kdmrc;

Cette section contient les options globales qui n'ont leur place dans aucune section specifique.

`ConfigVersion`

- Cette option existe uniquement pour faire des mises à jour automatiques propres. ne la modifiez pas, vous pourriez interférer avec de futures mises à jour et &kdm; pourrait ne plus fonctionner.

`StaticServers`

- List of displays (&X-Server;s) permanently managed by &kdm;. Displays with a hostname are foreign displays which are expected to be already running, the others are local displays for which &kdm; starts an own &X-Server;; see `ServerCmd`. Each display may belong to a display class; append it to the display name separated by an underscore. See kdmrc-xservers for the details.

  La valeur par défaut est :0.

`ReserveServers`

- Liste des affichages à la demande. Voir `StaticServers` pour la syntaxe.

  Vide par défaut.

`ServerVTs`

- List of Virtual Terminals to allocate to &X-Server;s. For negative numbers the absolute value is used, and the VT will be allocated only if the kernel says it is free. If &kdm; exhausts this list, it will allocate free VTs greater than the absolute value of the last entry in this list. Currently Linux only.

  Vide par défaut.

`ConsoleTTYs`

- This option is for operating systems (OSs) with support for virtual terminals (VTs), by both &kdm; and the OSs itself. Currently this applies only to Linux.

  Lorsque &kdm; bascule en mode console, il commence à surveiller toutes les lignes TTY listées ici (sans `/dev/` au début). Si aucune d'elle n'est active pendant un certain temps, &kdm; bascule à nouveau vers le login X.

  Vide par défaut.

`PidFile`

- The nom de fichier spécifié sera créé pour contenir une représentation ASCII de l'identifiant de processus du processus &kdm; principal ; le PID ne sera pas mémorisé sir le nom de fichier est vide.

  Vide par défaut.

`LockPidFile`

- Cette option contrôle si &kdm; utilise le verrouillage par fichier pour éviter que de multiples gestionnaires d'affichage soient lancés les uns sur les autres.

  La valeur par défaut est true.

`AuthDir`

- Ceci nomme un répertoire dans lequel &kdm; stocke des fichiers d'autorisation pour &X-Server; lorsqu'il initialise la session. &kdm; s'attend à ce que le système supprime les fichiers périmés de ce répertoire au redémarrage.

  Le fichier d'autorisation à utiliser pour un affichage particulier peut être spécifié avec l'option `AuthFile` dans [X-*-Core].

  La valeur par défaut est /var/run/xauth.

`AutoRescan`

- Cette valeur booléenne contrôle si &kdm; relit automatiquement ses fichiers de configuration s'il constate qu'ils ont changé.

  La valeur par défaut est true.

`ExportList`

- Additional environment variables &kdm; should pass on to all programs it runs. `LD_LIBRARY_PATH` and `XCURSOR_THEME` are good candidates; otherwise, it should not be necessary very often.

  Vide par défaut.

`RandomFile`

- If the system has no native entropy source like /dev/urandom (see `RandomDevice`) and no entropy daemon like EGD (see `PrngdSocket` and `PrngdPort`) is running, &kdm; will fall back to its own pseudo-random number generator that will, among other things, successively checksum parts of this file (which, obviously, should change frequently).

  Cette option n'existe pas sur Linux et divers BSDs.

  La valeur par défaut est /dev/mem.

`PrngdSocket`

- If the system has no native entropy source like /dev/urandom (see `RandomDevice`), read random data from a Pseudo-Random Number Generator Daemon, like EGD (http://egd.sourceforge.net) via this UNIX domain socket.

  Cette option n'existe pas sur Linux et divers BSDs.

  Vide par défaut.

`PrngdPort`

- Identique à `PrngdSocket`, n'utilise qu'une socket TCP sur localhost.

`RandomDevice`

- The path to a character device which &kdm; should read random data from. Empty means to use the system's preferred entropy device if there is one.

  Cette option n'existe pas sur OpenBSD, qui utilise la fonction arc4_random à la place.

  Vide par défaut.

`FifoDir`

- Le répertoire dans lequel les FiFos de commande doivent être créés ; ne pas mettre de valeur pour les désativer.

  La valeur par défaut est /var/run/xdmctl.

`FifoGroup`

- Le groupe auquel la FiFo de commande globale doit appartenir ; peut être un nom ou un identifiant numérique.

`DataDir`

- The directory in which &kdm; should store persistent working data; such data is, for example, the previous user that logged in on a particular display.

  La valeur par défaut est /var/lib/kdm.

`DmrcDir`

- The directory in which &kdm; should store users' `.dmrc` files. This is only needed if the home directories are not readable before actually logging in (like with AFS).

  Vide par défaut.

### La section [Xdmcp] de &kdmrc;

Cette section contient des options qui contrôlent comment &kdm; gère des requêtes &XDMCP;.

`Enable`

- Si &kdm; doit écouter les requêtes &XDMCP; entrantes.

  La valeur par défaut est true.

`Port`

- This indicates the UDP port number which &kdm; uses to listen for incoming &XDMCP; requests. Unless you need to debug the system, leave this with its default value.

  La valeur par défaut est 177.

`KeyFile`

- XDM-AUTHENTICATION-1 style &XDMCP; authentication requires a private key to be shared between &kdm; and the terminal. This option specifies the file containing those values. Each entry in the file consists of a display name and the shared key.

  Vide par défaut.

`Xaccess`

- To prevent unauthorized &XDMCP; service and to allow forwarding of &XDMCP; IndirectQuery requests, this file contains a database of hostnames which are either allowed direct access to this machine, or have a list of hosts to which queries should be forwarded to. The format of this file is described in kdmrc-xaccess.

  La valeur par défaut est ${`kde_confdir`}/kdm/Xaccess.

`ChoiceTimeout`

- Number of seconds to wait for the display to respond after the user has selected a host from the chooser. If the display sends an &XDMCP; IndirectQuery within this time, the request is forwarded to the chosen host; otherwise, it is assumed to be from a new session and the chooser is offered again.

  La valeur par défaut est 15.

`RemoveDomainname`

- When computing the display name for &XDMCP; clients, the name resolver will typically create a fully qualified host name for the terminal. As this is sometimes confusing, &kdm; will remove the domain name portion of the host name if it is the same as the domain name of the local host when this option is enabled.

  La valeur par défaut est true.

`SourceAddress`

- Utiliser l'adresse IP de la connexion entrante au lieu du nom d'hôte. Utilisez cette option sur les hôtes possédant plusieurs interfaces réseau (multihomed). Ceci permet d'éviter de se connecter à la mauvaise interface qui peut ne pas être active à cet instant.

  La valeur par défaut est false.

`Willing`

- This specifies a program which is run (as `root`) when an &XDMCP; DirectQuery or BroadcastQuery is received and this host is configured to offer &XDMCP; display management. The output of this program may be displayed in a chooser window. If no program is specified, the string Willing to manage is sent.

  Vide par défaut.

### La section [Shutdown] de &kdmrc;

Cette section contient des options globales concernant l'arrêt du système.

`HaltCmd`

- La commande (sujette à être découpée en mots) à lancer pour stopper/éteindre électriquement le système.

  La valeur par défaut est quelque chose qui convenait sur le système sur lequel &kdm; a été compilé, comme par exemple `/sbin/shutdown `-h` `now``.

`RebootCmd`

- La commande (sujette à être découpée en mots) à lancer pour redémarrer le système.

  La valeur par défaut est quelque chose qui convenait sur le système sur lequel &kdm; a été compilé, comme par exemple `/sbin/shutdown `-r` `now``.

`AllowFifo`

- Si on peut ou non arrêter le système avec la FiFo de commande globale.

  La valeur par défaut est false.

`AllowFifoNow`

- Si on peut ou non annuler des sessions en cours d'exécution lorsqu'on arrête le système via la FiFo de commande globale.

  Ceci n'aura aucun effet à moins que `AllowFifo` soit activé.

  La valeur par défaut est true.

`BootManager`

- Le gestionnaire de démarrage que &kdm; doit utiliser pour proposer des options de démarrage dans la boîte de dialogue d'arrêt.

  `None`

- aucun gestionnaire de démarrage

`Grub`

- Le gestionnaire de démarrage GRUB

`Lilo`

- Le gestionnaire de démarrage LILO (uniquement Linux sur i386 & x86-64)

La valeur par défaut est None.

### La section [X-*-Core] de &kdmrc;

This section class contains options concerning the configuration of the &kdm; backend (core).

`OpenDelay`

- Voir `OpenRepeat`.

  La valeur par défaut est 15.

`OpenTimeout`

- Voir `OpenRepeat`.

  La valeur par défaut est 120.

`OpenRepeat`

- These options control the behavior of &kdm; when attempting to open a connection to an &X-Server;. `OpenDelay` is the length of the pause (in seconds) between successive attempts, `OpenRepeat` is the number of attempts to make and `OpenTimeout` is the amount of time to spend on a connection attempt. After `OpenRepeat` attempts have been made, or if `OpenTimeout` seconds elapse in any particular connection attempt, the start attempt is considered failed.

  La valeur par défaut est 5.

`StartAttempts`

- How many times &kdm; should attempt to start a `foreign` display listed in `StaticServers` before giving up and disabling it. Local displays are attempted only once, and &XDMCP; displays are retried indefinitely by the client (unless the option `-once` was given to the &X-Server;).

  La valeur par défaut est 4.

`ServerAttempts`

- Le nombre de fois que &kdm; doit tenter de démarrer un &X-Server; local. Ceci inclut l'exécution en elle-même, et l'attente pour qu'il démarre effectivement.

  La valeur par défaut est 1.

`ServerTimeout`

- Le nombre de secondes que &kdm; doit attendre pour le démarrage d'un &X-Server; local.

  La valeur par défaut est 15.

`ServerCmd`

- Cette ligne de commande démarre le &X-Server;, sans numéro d'affichage et sans spécification de VT. Cette chaîne est sujette à être découpée en mots.

  La valeur par défaut est quelque chose qui convenait sur le système sur lequel &kdm; a été compilé, comme par exemple `/usr/X11R6/bin/X`.

`ServerArgsLocal`

- Arguments additionnels pour les &X-Server;s pour les sessions locales. Cette chaîne est sujette à être découpée en mots.

  Vide par défaut.

`ServerArgsRemote`

- Arguments additionnels pour les &X-Server;s pour les sessions distantes. Cette chaîne est sujette à être découpée en mots.

  Vide par défaut.

`ServerVT`

- The VT the &X-Server; should run on. `ServerVTs` should be used instead of this option. Leave it zero to let &kdm; assign a VT automatically. Set it to `-1` to avoid assigning a VT alltogether - this is required for setups with multiple physical consoles. Currently Linux only.

`ServerTTY`

- This option is for OSs without support for VTs, either by &kdm; or the OS itself. Currently this applies to all OSs but Linux.

  When &kdm; switches to console mode, it starts monitoring this TTY line (specified without the leading `/dev/`) for activity. If the line is not used for some time, &kdm; switches back to the X login.

  Vide par défaut.

`PingInterval`

- Voir `PingTimeout`.

  La valeur par défaut est 5.

`PingTimeout`

- To discover when remote displays disappear, &kdm; regularly pings them. `PingInterval` specifies the time (in minutes) between the pings and `PingTimeout` specifies the maximum amount of time (in minutes) to wait for the terminal to respond to the request. If the terminal does not respond, the session is declared dead and terminated.

  If you frequently use X terminals which can become isolated from the managing host, you may wish to increase the timeout. The only worry is that sessions will continue to exist after the terminal has been accidentally disabled.

  La valeur par défaut est 5.

`TerminateServer`

- Whether &kdm; should restart the local &X-Server; after session exit instead of resetting it. Use this if the &X-Server; leaks memory or crashes the system on reset attempts.

  La valeur par défaut est false.

`ResetSignal`

- Le numéro de signal à utiliser pour réinitialiser le &X-Server; local.

  La valeur par défaut est 1 (SIGHUP).

`TermSignal`

- Le numéro de signal à utiliser pour terminer le &X-Server; local.

  La valeur par défaut est 15 (SIGTERM).

`Authorize`

- Controls whether &kdm; generates and uses authorization for local &X-Server; connections. For &XDMCP; displays the authorization requested by the display is used; foreign non-&XDMCP; displays do not support authorization at all.

  La valeur par défaut est true.

`AuthNames`

- If `Authorize` is true, use the authorization mechanisms listed herein. The MIT-MAGIC-COOKIE-1 authorization is always available; XDM-AUTHORIZATION-1, SUN-DES-1 and MIT-KERBEROS-5 might be available as well, depending on the build configuration.

  La valeur par défaut est DEF_AUTH_NAME.

`ResetForAuth`

- Some old &X-Server;s re-read the authorization file at &X-Server; reset time, instead of when checking the initial connection. As &kdm; generates the authorization information just before connecting to the display, an old &X-Server; would not get up-to-date authorization information. This option causes &kdm; to send SIGHUP to the &X-Server; after setting up the file, causing an additional &X-Server; reset to occur, during which time the new authorization information will be read.

  La valeur par défaut est false.

`AuthFile`

- This file is used to communicate the authorization data from &kdm; to the &X-Server;, using the `-auth` &X-Server; command line option. It should be kept in a directory which is not world-writable as it could easily be removed, disabling the authorization mechanism in the &X-Server;. If not specified, a random name is generated from `AuthDir` and the name of the display.

  Vide par défaut.

`Resources`

- This option specifies the name of the file to be loaded by `xrdb` as the resource database onto the root window of screen 0 of the display. KDE programs generally do not use X-resources, so this option is only needed if the `Setup` program needs some X-resources.

  Vide par défaut.

`Xrdb`

- Le programme `xrdb` à utiliser pour lire le fichier des ressources X spécifié dans `Recources`. La commande est sujette à être découpée en mots.

  La valeur par défaut est ${`x_bindir`}/xrdb.

`Setup`

- This string is subject to word splitting. It specifies a program which is run (as `root`) before offering the greeter window. This may be used to change the appearance of the screen around the greeter window or to put up other windows (e.g., you may want to run `xconsole` here). The conventional name for a program used here is `Xsetup`. See kdmrc-xsetup.

  Vide par défaut.

`Startup`

- This string is subject to word splitting. It specifies a program which is run (as `root`) after the user authentication process succeeds. The conventional name for a program used here is `Xstartup`. See kdmrc-xstartup.

  Vide par défaut.

`Reset`

- This string is subject to word splitting. It specifies a program which is run (as `root`) after the session terminates. The conventional name for a program used here is `Xreset`. See kdmrc-xreset.

  Vide par défaut.

`Session`

- This string is subject to word splitting. It specifies the session program to be executed (as the user owning the session). The conventional name for a program used here is `Xsession`. See kdmrc-xsession.

  La valeur par défaut est ${`x_bindir`}/xterm -ls -T.

`FailsafeClient`

- If the `Session` program fails to execute, &kdm; will fall back to this program. This program is executed with no arguments, but executes using the same environment variables as the session would have had (see kdmrc-xsession).

  La valeur par défaut est ${`x_bindir`}/xterm.

`UserPath`

- La variable d'environment `PATH` pour les `Session`s non-`root`.

  La valeur par défaut dépend du système sur lequel &kdm; a été compilé.

`SystemPath`

- La variable d'environment `PATH` pour tous les programmes sauf les `Session`s non-`root`. Notez qu'il est de bonne pratique de ne pas inclure `.` (le répertoire courant) dans cette entrée.

  La valeur par défaut dépend du système sur lequel &kdm; a été compilé.

`SystemShell`

- The `SHELL` environment variable for all programs but the `Session`.

  La valeur par défaut est /bin/sh.

`UserAuthDir`

- When &kdm; is unable to write to the usual user authorization file ($`HOME`/.Xauthority), it creates a unique file name in this directory and points the environment variable `XAUTHORITY` at the created file.

  La valeur par défaut est /tmp.

`AutoReLogin`

- If enabled, &kdm; will automatically restart a session after an &X-Server; crash (or if it is killed by Alt-Ctrl-BackSpace). Note that enabling this feature opens a security hole: a secured display lock can be circumvented (unless &kde;'s built-in screen locker is used).

  La valeur par défaut est false.

`AllowRootLogin`

- Si désactivé, ne pas permettre à `root` (et tout autre utilisateur d'UID égal à 0) de se connecter directement.

  La valeur par défaut est true.

`AllowNullPasswd`

- Si désactivé, seuls les utilisateurs ayant un mot de passe assigné peuvent se connecter.

  La valeur par défaut est true.

`AllowShutdown`

- Qui peut arrêter le système. Ceci s'applique à la fois à l'écran d'accueil et à la FiFo de commande.

  `None`

- aucune entrée de menu Shutdown... ne sera montrée.

`Root`

- le mot de passe `root` devra être saisi pour l'arrêt

`All`

- tout le monde peut arrêter la machine

La valeur par défaut est All.

`AllowSdForceNow`

- Qui peut annuler les sessions actives lors d'une demande d'arrêt.

  `None`

- Aucun arrêt forcé n'est permis

`Root`

- le mot de passe `root` devra être saisi pour forcer un arrêt.

`All`

- tout le monde peut arrêter la machine de manière forcée

La valeur par défaut est All.

`DefaultSdMode`

- Le choix par défaut pour les conditions/synchronisations d'arrêt.

  `Schedule`

- arrêt après la fin de toutes les sessions actives (probablement immédiatement)

`TryNow`

- arrêt si aucune session active n'est ouverte, sinon ne fait rien

`ForceNow`

- arrêt sans condition

La valeur par défaut est Schedule.

`ScheduledSd`

- Comment proposer des options de planification d'arrêt :

  `Never`

- aucune

`Optionnel`

- sous forme de bouton dans les boîtes de dialogue d'arrêt simple

`Toujours`

- au lieu des boîtes de dialogue d'arrêt simple

La valeur par défaut est Never.

`NoPassEnable`

- Active la connexion sans mot de passe pour cet affichage. À utiliser avec une extrême prudence !

  La valeur par défaut est false.

`NoPassUsers`

- The users that do not need to provide a password to log in. Items which are prefixed with `@` represent all users in the user group named by that item. `*` means all users but `root` (and any other user with UID = 0). Never list `root`.

  Vide par défaut.

`AutoLoginEnable`

- Active la connexion automatique. À utiliser avec une extrême prudence !

  La valeur par défaut est false.

`AutoLoginAgain`

- Si ceci est activé, une connexion automatique aura lieu après une déconnexion. Sinon, une connexion automatique aura lieu seulement au démarrage d'une session d'affichage.

  La valeur par défaut est false.

`AutoLoginDelay`

- Le délai en secondes avant qu'une connexion automatique démarre. Ceci est aussi connu en tant que Timed Login.

`AutoLoginUser`

- L'utilisateur à connecter automatiquement. Ne spécifiez jamais `root` !

  Vide par défaut.

`AutoLoginPass`

- Le mot de passe pour l'utilisateur à connecter automatiquement. Ce n' est pas obligatoire à moins que l'utilisateur se connecte dans un domaine NIS ou Kerberos. Si vous utilisez cette option, vous devriez faire un `chmod `600` `kdmrc`` pour des raisons évidentes.

  Vide par défaut.

`AutoLoginLocked`

- Verrouiller immediatement la session démarrée automatiquement. Ceci ne fonctionne qu'avec les sessions KDE.

  La valeur par défaut est false.

`SessionsDirs`

- Une liste de répertoires contenant les définitions de types de session.

  La valeur par défaut est ${`kde_datadir`}/kdm/sessions.

`ClientLogFile`

- The file (relative to the user's home directory) to redirect the session output to. One occurrence of `%s` in this string will be substituted with the display name. Use `%%` to obtain a literal `%`.

  La valeur par défaut est .xsession-errors.

`UseSessReg`

- Specify whether &kdm;'s built-in utmp/wtmp/lastlog registration should be used. If it is not, the tool `sessreg` should be used in the `Startup` and `Reset` scripts, or, alternatively, the pam_lastlog module should be used on PAM-enabled systems.

  La valeur par défaut est true.

### La section [X-*-Greeter] de &kdmrc;

This section class contains options concerning the configuration of the &kdm; frontend (greeter).

`GUIStyle`

- Specify the widget style for the greeter. Empty means to use the built-in default which currently is `Plastik`.

  Vide par défaut.

`ColorScheme`

- Specify the widget color scheme for the greeter. Empty means to use the built-in default which currently is yellowish grey with some light blue and yellow elements.

  Vide par défaut.

`LogoArea`

- What should be shown in the greeter righthand of the input lines (if `UserList` is disabled) or above them (if `UserList` is enabled):

  `None`

- rien

`Logo`

- l'image spécifiée par `LogoPixmap`.

`Clock`

- une horloge analogique

La valeur par défaut est Clock.

`LogoPixmap`

- L'image à afficher dans l'écran d'accueil lorsque `LogoArea` vaut `Logo`.

  Vide par défaut.

`GreeterPos`

- The relative coordinates (percentages of the screen size; X,Y) at which the center of the greeter is put. &kdm; aligns the greeter to the edges of the screen it would cross otherwise.

  La valeur par défaut est 50,50.

`GreeterScreen`

- Le moniteur sur lequel l'écran d'accueil doit être affiché dans une configuration à plusieurs moniteurs et dans les configurations Xinerama. La numérotation débute 0. Pour Xinerama, elle correspond à l'ordre d'énumération dans la section ServerLayout active du fichier XF86Config ; -1 signifie d'utiliser l'écran en haut à gauche, -2 signifie d'utiliser l'écran en haut à droite.

`GreetString`

- Le titre de l'écran d'accueil. Une abscence de valeur signifie aucun titre.

  Les caractères suivants sont remplacés par leur valeur :

  `%d`

- nom de l'affichage actuel

`%h`

- nom d'hôte local, éventuellement avec le nom de domaine

`%n`

- le nom du noeud local, probablement le nom d'hôte sans le nom de domaine

`%s`

- le système d'exploitation

`%r`

- la version du système d'exploitation

`%m`

- le type de machine (matériel)

`%%`

- un simple `%`

La valeur par défaut est Welcome to %s at %n.

`AntiAliasing`

- Si les polices affichées dans l'écran d'accueil doivent être lissées ou non (antialiasing).

  La valeur par défaut est false.

`GreetFont`

- La police de caractères à utiliser pour le titre de l'écran d'accueil.

  La valeur par défaut est Serif,20,bold.

`StdFont`

- La police de caractères standard à utiliser dans l'écran d'accueil.

  La valeur par défaut est Sans Serif,10.

`FailFont`

- La police de caractères à utiliser pour le message Login Failed.

  La valeur par défaut est Sans Serif,10,bold.

`NumLock`

- Ce qu'il faut faire concernant le verrouillage du pavé numérique (Num Lock) lorsque l'écran d'accueil est exécuté :

  `Off`

- désactiver

`On`

- activer

`Keep`

- ne pas changer l'état

La valeur par défaut est Keep.

`Langue`

- Langue et locale à utiliser dans l'écran d'accueil, encodé comme $`LC_LANG`

  La valeur par défaut est en_US.

`UserCompletion`

- Activer la complétion automatique dans la ligne d'édition du nom d'utilisateur.

  La valeur par défaut est false.

`UserList`

- Montrer une liste d'utilisateurs avec les noms de connexion de type UNIX, les noms réels, et les images dans l'écran d'accueil.

  La valeur par défaut est true.

`ShowUsers`

- This option controls which users will be shown in the user view (`UserList`) and/or offered for autocompletion (`UserCompletion`). If it is `Selected`, `SelectedUsers` contains the final list of users. If it is `NotHidden`, the initial user list contains all users found on the system. Users contained in `HiddenUsers` are removed from the list, just like all users with a UID greater than specified in `MaxShowUID` and users with a non-zero UID less than specified in `MinShowUID`. Items in `SelectedUsers` and `HiddenUsers` which are prefixed with `@` represent all users in the user group named by that item. Finally, the user list will be sorted alphabetically, if `SortUsers` is enabled.

  La valeur par défaut est NotHidden.

`SelectedUsers`

- Voir `ShowUsers`.

  Vide par défaut.

`HiddenUsers`

- Voir `ShowUsers`.

  Vide par défaut.

`MinShowUID`

- Voir `ShowUsers`.

`MaxShowUID`

- Voir `ShowUsers`.

  La valeur par défaut est 65535.

`SortUsers`

- Voir `ShowUsers`.

  La valeur par défaut est true.

`FaceSource`

- Si `UserList` est activé, ceci indique de quel emplacement &kdm; récupère les images :

  `AdminOnly`

- depuis `<`FaceDir`>/$`USER`.face[.icon]`

`PreferAdmin`

- préférer <`FaceDir`>, se rabattre sur $`HOME`

`PreferUser`

- ... dans l'autre sens

`UserOnly`

- depuis le `$`HOME`/.face[.icon]` de l'utilisateur

The images can be in any format Qt recognizes, but the filename must match &kdm;'s expectations: `.face.icon` should be a 48x48 icon, while `.face` should be a 300x300 image. Currently the big image is used only as a fallback and is scaled down, but in the future it might be displayed full-size in the logo area or a tooltip.

La valeur par défaut est AdminOnly.

`FaceDir`

- Voir `FaceSource`.

  La valeur par défaut est ${`kde_datadir`}/kdm/faces.

`PreselectUser`

- Spécifier si un utilisateur doit être présélectionné pour la connexion et, le cas échéant, lequel :

  `None`

- ne présélectionner aucun utilisateur

`Previous`

- le dernier utilisateur qui se soit connecté avec succès

`Default`

- l'utilisateur spécifié dans l'option `DefaultUser`

If `FocusPasswd` is enabled and a user was preselected, the cursor is placed in the password input field automatically.

Activer la présélection d'utilisateur peut être considéré comme une faille de sécurité, puisqu'elle présente un nom de connexion valide à un attaquant éventuel, et qu'il n'a alors qu'à deviner le mot de passe. D'un autre côté, on pourrait positionner `DefaultUser` à une fausse valeur de nom de connexion.

La valeur par défaut est None.

`DefaultUser`

- Voir `PreselectUser`.

  Vide par défaut.

`FocusPasswd`

- Voir `PreselectUser`.

  La valeur par défaut est false.

`EchoMode`

- Le champ de saisie du mot de passe masque le texte saisi. Spécifier ici la façon dont ceci est réalisé :

  `OneStar`

- `*` est affiché pour chaque caractère saisi

`ThreeStars`

- `***` est affiché pour chaque caractère saisi

`NoEcho`

- rien n'est affiché, le curseur ne bouge pas

La valeur par défaut est OneStar.

`UseBackground`

- If enabled, &kdm; will automatically start the `krootimage` program to set up the background; otherwise, the `Setup` program is responsible for the background.

  La valeur par défaut est true.

`BackgroundCfg`

- The configuration file to be used by `krootimage`. It contains a section named `[Desktop0]` like `kdesktoprc` does. Its options are not described herein; guess their meanings or use the control center.

  La valeur par défaut est ${`kde_confdir`}/kdm/backgroundrc.

`GrabServer`

- To improve security, the greeter grabs the &X-Server; and then the keyboard when it starts up. This option specifies if the &X-Server; grab should be held for the duration of the name/password reading. When disabled, the &X-Server; is ungrabbed after the keyboard grab succeeds; otherwise, the &X-Server; is grabbed until just before the session begins.

  Activer cette option désactive `UseBackground` et `Setup`.

  La valeur par défaut est false.

`GrabTimeout`

- This option specifies the maximum time &kdm; will wait for the grabs to succeed. A grab may fail if some other X-client has the &X-Server; or the keyboard grabbed, or possibly if the network latencies are very high. You should be cautious when raising the timeout, as a user can be spoofed by a look-alike window on the display. If a grab fails, &kdm; kills and restarts the &X-Server; (if possible) and the session.

  La valeur par défaut est 3.

`AuthComplain`

- Avertir, si un affichage n'a pas d'autorisation X (X-authorization). Ceci sera le cas si

  - le fichier d'autorisation pour un &X-Server; local ne peut pas être créé,

  - un affichage distant de &XDMCP; n'a demandé aucune autorisation ou

  - l'affichage est un affichage étranger spécifié dans `StaticServers`.

  La valeur par défaut est true.

`LoginMode`

- Spécifie si l'écran d'accueil des affichages locaux soit être démarré en mode sélectionneur d'hôtes (distant) ou connexion (local) et s'il est permis de basculer entre ces deux modes.

  `LocalOnly`

- Seules les connexions locales sont possibles

`DefaultLocal`

- Démarrage en mode local, mais permet de basculer en mode distant

`DefaultRemote`

- ... dans l'autre sens

`RemoteOnly`

- Seul le choix d'hôtes distants est possible

La valeur par défaut est LocalOnly.

`ChooserHosts`

- Liste d'hôtes séparés par des virgules à ajouter automatiquement au menu de connexion distante. Le nom spécial `*` signifie broadcast, et n'a pas d'effet si `LoginMode` vaut `LocalOnly`.

  La valeur par défaut est *.

`ForgingSeed`

- Use this number as a random seed when forging saved session types, etc. of unknown users. This is used to avoid telling an attacker about existing users by reverse conclusion. This value should be random but constant across the login domain.

`ShowLog`

- Enable &kdm;'s built-in `xconsole`. Note that this can be enabled for only one display at a time. This option is available only if &kdm; was `configure`d with `--enable-kdm-xconsole`.

  La valeur par défaut est false.

`LogSource`

- The data source for &kdm;'s built-in `xconsole`. If empty, a console log redirection is requested from `/dev/console`. Has no effect if `ShowLog` is disabled.

  Vide par défaut.

`PluginsLogin`

- Specify conversation plugins for the login dialog; the first in the list is selected initially. Each plugin can be specified as a base name (which expands to `$`kde_modulesdir`/kgreet_`base``) or as a full pathname.

  Conversation plugins are modules for the greeter which obtain authentication data from the user. Currently only the `classic` plugin is shipped with &kde;; it presents the well-known username and password form.

  La valeur par défaut est classic.

`PluginsShutdown`

- Identique à `PluginsLogin`, mais pour la boîte de dialogue d'arrêt.

  La valeur par défaut est classic.

`PluginOptions`

- A list of options of the form `Key``=``Value`. The conversation plugins can query these settings; it is up to them what possible keys are.

  Vide par défaut.

`AllowConsole`

- Montre l'action Passer en mode console dans l'écran d'accueil (si `ServerTTY`/`ConsoleTTYs` est configuré).

  La valeur par défaut est true.

`AllowClose`

- Montre l'action Redémarrer le serveur X/Close Connection dans l'écran d'accueil.

  La valeur par défaut est true.

`Preloader`

- Un programme à exécuter lorsque l'écran d'accueil est visible. Dans la mesure du possible, il est supposé être préchargé avant la session qui est sur le point d'être démarrée (le plus probablement).

  Vide par défaut.

`UseTheme`

- Si des thèmes peuvent être appliqués à l'écran d'accueil.

  La valeur par défaut est false.

`Theme`

- Le thème à utiliser pour l'écran d'accueil. Peut pointer soit sur un répertoire soit sur un fichier XML.

  Vide par défaut.

## Spécifier des &X-Server;s permanents

Each entry in the `StaticServers` list indicates a display which should constantly be managed and which is not using &XDMCP;. This method is typically used only for local &X-Server;s that are started by &kdm;, but &kdm; can manage externally started (foreign) &X-Server;s as well, may they run on the local machine or rather remotely.

The formal syntax of a specification is

    display name [_display class]

for all &X-Server;s. Foreign displays differ in having a host name in the display name, may it be `localhost`.

The `display name` must be something that can be passed in the `-display` option to an X program. This string is used to generate the display-specific section names, so be careful to match the names. The display name of &XDMCP; displays is derived from the display's address by reverse host name resolution. For configuration purposes, the `localhost` prefix from locally running &XDMCP; displays is not stripped to make them distinguishable from local &X-Server;s started by &kdm;.

The `display class` portion is also used in the display-specific sections. This is useful if you have a large collection of similar displays (such as a corral of X terminals) and would like to set options for groups of them. When using &XDMCP;, the display is required to specify the display class, so the manual for your particular X terminal should document the display class string for your device. If it does not, you can run &kdm; in debug mode and `grep` the log for class.

The displays specified in `ReserveServers` will not be started when &kdm; starts up, but when it is explicitly requested via the command socket (or FiFo). If reserve displays are specified, the &kde; menu will have a Start New Session item near the bottom; use that to activate a reserve display with a new login session. The monitor will switch to the new display, and you will have a minute to login. If there are no more reserve displays available, the menu item will be disabled.

When &kdm; starts a session, it sets up authorization data for the &X-Server;. For local servers, &kdm; passes ``-auth` ``filename``` on the &X-Server;'s command line to point it at its authorization data. For &XDMCP; displays, &kdm; passes the authorization data to the &X-Server; via the Accept &XDMCP; message.

## Contrôle d'accès de &XDMCP;

The file specified by the `AccessFile` option provides information which &kdm; uses to control access from displays requesting service via &XDMCP;. The file contains four types of entries: entries which control the response to Direct and Broadcast queries, entries which control the response to Indirect queries, macro definitions for Indirect entries, and entries which control on which network interfaces &kdm; listens for &XDMCP; queries. Blank lines are ignored, `#` is treated as a comment delimiter causing the rest of that line to be ignored, and `\` causes an immediately following newline to be ignored, allowing indirect host lists to span multiple lines.

The format of the Direct entries is simple, either a host name or a pattern, which is compared against the host name of the display device. Patterns are distinguished from host names by the inclusion of one or more meta characters; `*` matches any sequence of 0 or more characters, and `?` matches any single character. If the entry is a host name, all comparisons are done using network addresses, so any name which converts to the correct network address may be used. Note that only the first network address returned for a host name is used. For patterns, only canonical host names are used in the comparison, so ensure that you do not attempt to match aliases. Host names from &XDMCP; queries always contain the local domain name even if the reverse lookup returns a short name, so you can use patterns for the local domain. Preceding the entry with a `!` character causes hosts which match that entry to be excluded. To only respond to Direct queries for a host or pattern, it can be followed by the optional `NOBROADCAST` keyword. This can be used to prevent a &kdm; server from appearing on menus based on Broadcast queries.

An Indirect entry also contains a host name or pattern, but follows it with a list of host names or macros to which the queries should be forwarded. Indirect entries can be excluding as well, in which case a (valid) dummy host name must be supplied to make the entry distinguishable from a Direct entry. If compiled with IPv6 support, multicast address groups may also be included in the list of addresses the queries are forwarded to. If the indirect host list contains the keyword `CHOOSER`, Indirect queries are not forwarded, but instead a host chooser dialog is displayed by &kdm;. The chooser will send a Direct query to each of the remaining host names in the list and offer a menu of all the hosts that respond. The host list may contain the keyword `BROADCAST`, to make the chooser send a Broadcast query as well; note that on some operating systems, UDP packets cannot be broadcast, so this feature will not work.

When checking access for a particular display host, each entry is scanned in turn and the first matching entry determines the response. Direct and Broadcast entries are ignored when scanning for an Indirect entry and vice-versa.

A macro definition contains a macro name and a list of host names and other macros that the macro expands to. To distinguish macros from hostnames, macro names start with a `%` character.

The last entry type is the `LISTEN` directive. The formal syntax is

     LISTEN [interface [multicast list]]

If one or more `LISTEN` lines are specified, &kdm; listens for &XDMCP; requests only on the specified interfaces. `interface` may be a hostname or IP address representing a network interface on this machine, or the wildcard `*` to represent all available network interfaces. If multicast group addresses are listed on a `LISTEN` line, &kdm; joins the multicast groups on the given interface. For IPv6 multicasts, the IANA has assigned ff0`X`:0:0:0:0:0:0:12b as the permanently assigned range of multicast addresses for &XDMCP;. The `X` in the prefix may be replaced by any valid scope identifier, such as 1 for Node-Local, 2 for Link-Local, 5 for Site-Local, and so on (see IETF RFC 2373 or its replacement for further details and scope definitions). &kdm; defaults to listening on the Link-Local scope address ff02:0:0:0:0:0:0:12b to most closely match the IPv4 subnet broadcast behavior. If no `LISTEN` lines are given, &kdm; listens on all interfaces and joins the default &XDMCP; IPv6 multicast group (when compiled with IPv6 support). To disable listening for &XDMCP; requests altogether, a `LISTEN` line with no addresses may be specified, but using the `[Xdmcp]` `Enable` option is preferred.

## Programmes supplémentaires

Les programmes suivants sont exécutés par &kdm; à différentes étapes d'une session. Ce sont typiquement des scripts shell.

Les programmes de configuration, de démarrage et de réinitialisation sont exécutés en tant que `root`, ils doivent donc faire attention à propos des problèmes de sécurité. Leur premier argument est `auto` si la session résulte d'une connexion automatique ; sinon, aucun argument ne leur est transmis.

### Programme de configuration

Le programme `Xsetup` est exécuté après le démarrage ou la réinitialisation du &X-Server;, mais avant que l'écran d'accueil ne soit affiché. C'est l'endroit où changer l'arrière plan de base (si `UseBackground` est désactivé) ou faire surgir d'autres fenêtres qui doivent apparaître sur le moniteur avec l'écran d'accueil.

En sus de toutes celles qui peuvent être spécifiées dans `ExportList`, les variables d'environment suivantes sont transmises :

DISPLAY

- le nom d'affichage associé

PATH

- la valeur de `SystemPath`

SHELL

- la valeur de `SystemShell`

XAUTHORITY

- peut contenir un fichier d'autorité

DM_CONTROL

- la valeur de `FifoDir`

Note that since &kdm; grabs the keyboard, any other windows will not be able to receive keyboard input. They will be able to interact with the mouse, however; beware of potential security holes here. If `GrabServer` is set, `Xsetup` will not be able to connect to the display at all. Resources for this program can be put into the file named by `Resources`.

### Programme de démarrage

The `Xstartup` program is run as `root` when the user logs in. This is the place to put commands which add entries to `utmp` (the `sessreg` program may be useful here), mount users' home directories from file servers, or abort the session if some requirements are not met (but note that on modern systems, many of these tasks are already taken care of by PAM modules).

En sus de toutes celles qui peuvent être spécifiées dans `ExportList`, les variables d'environment suivantes sont transmises :

DISPLAY

- le nom d'affichage associé

HOME

- le répertoire de travail initial de l'utilisateur

LOGNAME

- le nom d'utilisateur

USER

- le nom d'utilisateur

PATH

- la valeur de `SystemPath`

SHELL

- la valeur de `SystemShell`

XAUTHORITY

- peut contenir un fichier d'autorité

DM_CONTROL

- la valeur de `FifoDir`

&kdm; waits until this program exits before starting the user session. If the exit value of this program is non-zero, &kdm; discontinues the session and starts another authentication cycle.

### Programme de session

The `Xsession` program is the command which is run as the user's session. It is run with the permissions of the authorized user. One of the keywords `failsafe`, `default` or `custom`, or a string to `eval` by a Bourne-compatible shell is passed as the first argument.

En sus de toutes celles qui peuvent être spécifiées dans `ExportList`, les variables d'environment suivantes sont transmises :

DISPLAY

- le nom d'affichage associé

HOME

- le répertoire de travail initial de l'utilisateur

LOGNAME

- le nom d'utilisateur

USER

- le nom d'utilisateur

PATH

- la valeur de `UserPath` (ou `SystemPath` pour les sessions utilisateur de `root`)

SHELL

- le shell par défaut de l'utilisateur

XAUTHORITY

- peut contenir un fichier d'autorité non standard

KRBTKFILE

- peut contenir un nom de cache d'autorisations Kerberos4

KRB5CCNAME

- peut contenir un nom de cache d'autorisations Kerberos5

DM_CONTROL

- la valeur de `FifoDir`

XDM_MANAGED

- will contain a comma-separated list of parameters the session might find interesting, like the location of the command FiFo and its capabilities, and which conversation plugin was used for the login

DESKTOP_SESSION

- le nom de la session que l'utilisateur a choisi d'exécuter

### Programme de réinitialisation

Symmetrical with `Xstartup`, the `Xreset` program is run after the user session has terminated. Run as `root`, it should contain commands that undo the effects of commands in `Xstartup`, removing entries from `utmp` or unmounting directories from file servers.

Les variables d'environment qui ont été transmises à `Xstartup` le sont aussi à `Xreset`.