NSCD.CONF

NOM

DESCRIPTION

Le fichier de configuration se compose d'un ensemble de lignes. Les lignes vides et le texte situé après un « # » sont ignorés. Toutes les autres lignes correspondent à la définition d'une option. Les espaces avant et après les options et entre les options et leurs arguments sont ignorés.

Les options sont de deux sortes : les options générales influent sur le comportement général de nscd(8), alors que les options relatives à la mise en cache n'affectent que le cache spécifié. Les options sont définies comme suit :

  option_générale option
  option_de_mise_en_cache nom_cache option

OPTIONS GÉNÉRALES

logfile nom_fichier

Cette option permet de spécifier le nom du fichier journal de débogage que nscd(8) doit utiliser si debug-level est supérieur à 0. Si cette option n'est pas définie, nscd(8) écrira sa sortie de débogage sur l'erreur standard.

debug-level niveau

Si niveau est supérieur à 0, nscd(8) va fournir des informations de débogage sur sa sortie. Plus haut sera le niveau, plus explicite sera la sortie.

threads nombre

Cette option permet de définir le nombre de threads que nscd(8) doit utiliser par défaut. Cette option peut être outrepassée en appelant nscd(8) avec l'argument -t ou --nthreads. Dans le cas où ni cette option n'est définie, ni l'argument de ligne de commande n'est fourni, nscd(8) utilisera 5 threads par défaut. Le nombre de threads minimal est de 3. Avec un nombre de threads plus élevé, nscd(8) pourra gérer plus de connexions simultanées.

max-threads nombre

Cette option permet de définir le nombre maximal de threads à démarrer.

server-user utilisateur

Par défaut, nscd(8) est exécuté en tant que « root ». Cette option permet de forcer nscd(8) à supprimer ses privilèges de « root » après démarrage. Elle ne peut pas être utilisée si nscd(8) est appelé avec l'argument -S ou --secure. Notez aussi que certains services nécessitent l'exécution de nscd(8) en tant que « root », et utiliser cette option dans ce cas pourra interrompre ces services de recherche.

stat-user utilisateur

Cette option permet de spécifier l'utilisateur autorisé à demander les statistiques.

paranoia booléen

Cette option permet d'activer le mode paranoïa qui force nscd(8) à se relancer de lui-même périodiquement. booléen doit être égal à yes ou no.

restart-interval nombre

Cette option permet de définit l'intervalle de redémarrage à nombre secondes si le redémarrage périodique est activé en utilisant le mode paranoia. La valeur par défaut est 3600.

OPTIONS DE MISE EN CACHE

enable-cache service booléen

Tous les caches sont désactivés par défaut et doivent être activés explicitement en définissant cette option à yes. booléen doit être égal à yes ou no.

positive-time-to-live service nombre

Cette option permet de définir le nombre de secondes après lequel une entrée de cache est supprimée du cache spécifié. La valeur par défaut est de 3600 secondes (c'est-à-dire une heure).

negative-time-to-live service nombre

Si une entrée n'est pas trouvée par le service de nom, elle est ajoutée au cache spécifié et marquée comme « not existent » (non existante). Cette option permet de définir le nombre de secondes après lequel une entrée non existante est supprimée du cache spécifié. La valeur par défaut est de 20 secondes pour les caches password et host et de 60 secondes pour le cache group.

suggested-size service nombre_premier

Cette option permet de définir la taille du hachage utilisé pour stocker les entrées du cache spécifié. Comme il s'agit d'un hachage, il doit être sensiblement plus grand que le nombre maximal d'entrées mises en cache simultanément et sa taille doit correspondre à un nombre premier. La taille par défaut est de 211 entrées.

check-files service booléen

Si la vérification de fichier est activée, nscd(8) vérifie périodiquement l'heure de modification de /etc/passwd, /etc/group ou /etc/hosts (pour les caches passwd, group et host, respectivement) et rend le cache non valable si le fichier a été modifié depuis la dernière vérification. booléen doit être égal à yes ou no.

persistent service booléen

Conserver le contenu du cache de service lors des redémarrages de nscd(8). Cette option peut s'avérer utile lorsque le mode paranoia est activé. booléen doit être égal à yes (valeur par défaut) ou no.

shared service booléen

La projection mémoire des bases de données de nscd(8) pour service est partagée avec les clients. Ils peuvent ainsi effectuer une recherche directe dans celles-ci au lieu de faire appel au démon sur le socket chaque fois qu'une recherche est effectuée. booléen doit être égal à yes (valeur par défaut) ou no.

reload-count nombre

Cette option permet de définir le nombre de fois qu'une entrée du cache est rechargée avant d'être supprimée du cache. Chaque entrée du cache possède une durée de vie ; lorsque cette durée de vie est atteinte, nscd(8) va recharger l'entrée (refaire appel au service NSS si la donnée n'a pas été modifiée) ou la supprimer.

max-db-size service nombre_octets

Cette option permet de définir la taille maximale pouvant être allouée pour le service spécifié.

auto-propagate service booléen

Si cette option est définie à no pour les services passwd ou group, les requêtes .byname ne sont pas ajoutées aux caches passwd.byuid ou group.bygid, ce qui peut s'avérer utile avec les tables qui contiennent plusieurs enregistrements pour le même identifiant.

EXEMPLE

# Ceci est un commentaire.

    logfile                 /var/log/nscd.log
    threads                 6
    server-user             nobody
    debug-level             0

    enable-cache            passwd          yes
    positive-time-to-live   passwd          600
    negative-time-to-live   passwd          20
    suggested-size          passwd          211
    check-files             passwd          yes

    enable-cache            group           yes
    positive-time-to-live   group           3600
    negative-time-to-live   group           60
    suggested-size          group           211
    check-files             group           yes

    enable-cache            hosts           yes
    positive-time-to-live   hosts           3600
    negative-time-to-live   hosts           20
    suggested-size          hosts           211
    check-files             hosts           yes

VOIR AUSSI

TRADUCTION

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à

Index

NOM

DESCRIPTION

OPTIONS GÉNÉRALES

OPTIONS DE MISE EN CACHE

EXEMPLE

VOIR AUSSI

TRADUCTION