.\" -*- coding: UTF-8 -*-
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH nsswitch.conf 5 "17 mai 2025" "Pages du manuel de Linux 6.15"
.SH NOM
nsswitch.conf \- Fichier de configuration du service de noms (« Name Service
Switch »)
.SH DESCRIPTION
Le fichier de configuration du service de noms (« Name Service Switch » ou
NSS), \fI/etc/nsswitch.conf\fP, est utilisé par la bibliothèque C de GNU et
d’autres applications pour déterminer les sources à partir desquelles
obtenir les renseignements de service de noms en fonction des catégories et
dans quel ordre. Chaque catégorie de renseignement est identifiée par un nom
de base de données.
.P
Le fichier est en texte ASCII, avec les colonnes séparées par des espaces ou
des tabulations. La première colonne indique le nom de la base de
données. Les autres colonnes décrivent les sources, dans l'ordre des
requêtes à réaliser, et un ensemble limité d'actions possibles en fonction
du résultat de la résolution.
.P
Les bases de données suivantes sont comprises par la bibliothèque C de GNU :
.TP 12
\fBaliases\fP
Alias d'adresses électroniques, utilisés par \fBgetaliasent\fP(3) et les
fonctions apparentées.
.TP
\fBethers\fP
Numéros Ethernet.
.TP
\fBgroup\fP
Groupes d'utilisateurs, utilisés par \fBgetgrent\fP(3) et les fonctions
apparentées.
.TP
\fBhosts\fP
Noms d'hôtes et leurs adresses, utilisés par \fBgethostbyname\fP(3) et les
fonctions apparentées.
.TP
\fBinitgroups\fP
Liste d'accès à des groupes supplémentaires utilisée par la fonction
\fBgetgrouplist\fP(3).
.TP
\fBnetgroup\fP
Liste d'hôtes et d'utilisateurs valable pour l'ensemble du réseau, servant à
établir les règles d'accès. Les bibliothèques C antérieures à la glibc 2.1
ne géraient les groupes réseau qu'avec NIS.
.TP
\fBnetworks\fP
Noms et masques de réseau, utilisés par \fBgetnetent\fP(3) et les fonctions
apparentées.
.TP
\fBpasswd\fP
Mots de passe des utilisateurs, utilisés par \fBgetpwent\fP(3) et les fonctions
apparentées.
.TP
\fBprotocols\fP
Protocoles réseau, utilisés par \fBgetprotoent\fP(3) et les fonctions
apparentées.
.TP
\fBpublickey\fP
Clés publiques et privées des « secure_RPC », utilisées par NFS et NIS+.
.TP
\fBrpc\fP
Noms et numéros de RPC, utilisés par \fBgetrpcbyname\fP(3) et les fonctions
apparentées.
.TP
\fBservices\fP
Services réseau, utilisés par \fBgetservent\fP(3) et les fonctions apparentées.
.TP
\fBshadow\fP
Mots de passe cachés des utilisateurs utilisés par \fBgetspnam\fP(3) et les
fonctions apparentées.
.P
La bibliothèque GNU C ignore les bases de données avec des noms
inconnus. Certaines applications utilisent cela pour mettre en œuvre une
gestion spéciale pour leur propre base de données. Par exemple, \fBsudo\fP(8)
consulte la base de données \fBsudoers\fP. La délégation d’ID
utilisateur/groupe subalternes peut être configurée en utilisant la base de
données \fBsubid\fP. Consulter \fBsubuid\fP(5) et \fBsubgid\fP(5) pour plus de
détails.
.P
Voici un exemple de fichier \fI/etc/nsswitch.conf\fP :
.P
.in +4n
.EX
passwd: compat
group: compat
shadow: compat
\&
hosts: dns [!UNAVAIL=return] files
networks: nis [NOTFOUND=return] files
ethers: nis [NOTFOUND=return] files
protocols: nis [NOTFOUND=return] files
rpc: nis [NOTFOUND=return] files
services: nis [NOTFOUND=return] files
.EE
.in
.P
La première colonne est le nom de la base de données. Les autres colonnes
indiquent :
.IP \- 3
une ou plusieurs spécifications de service, par exemple « files », « db » ou
« nis ». L'ordre des services sur la ligne indique l'ordre dans lequel les
requêtes seront réalisées sur ces services, tour à tour, jusqu'à ce qu'un
résultat soit obtenu ;
.IP \-
des actions facultatives à réaliser si un résultat particulier est obtenu du
service précédent, par exemple « [NOTFOUND=return] ».
.P
Les spécifications de service prises en charge sur le système dépendent de
la présence de bibliothèques partagées, et sont par conséquent
évolutives. Les bibliothèques appelées \fI/lib/libnss_SERVICE.so.\fP\fBX\fP
fourniront le \fISERVICE\fP indiqué. Sur une installation de base, « files »,
« db », « nis » et « nisplus » sont utilisables. Pour la base de données
\fBhosts\fP, « dns » peut aussi être indiqué. Pour les bases de données
\fBpasswd\fP, \fBgroup\fP et \fBshadow\fP, « compat » peut aussi être indiqué
(consulter \fBMode de compatibilité\fP ci\-dessous). Le numéro de version \fBX\fP
peut être 1 pour la glibc 2.0 ou 2 pour la glibc 2.1 et les versions
ultérieures. Sur les systèmes avec des bibliothèques supplémentaires
installées, d'autres services peuvent être disponibles comme « hesiod »,
« ldap », « winbind » et « wins ».
.P
Une action peut aussi être indiquée après une spécification de
service. L'action modifie le comportement après un résultat obtenu de la
source de données précédente. Les actions sont désignées sous la forme
générale :
.P
.RS 4
[\fIÉTAT\fP=\fIACTION\fP]
.br
[!\fIÉTAT\fP=\fIACTION\fP]
.RE
.P
où
.P
.RS 4
\fIÉTAT\fP => \fBsuccess\fP | \fBnotfound\fP | \fBunavail\fP | \fBtryagain\fP
.br
\fIACTION\fP => \fBreturn\fP | \fBcontinue\fP | \fBmerge\fP
.RE
.P
Le ! inverse le résultat du test, en correspondant à tous les résultats
possibles sauf celui indiqué. La casse des mots\-clés n'est pas importante.
.P
La valeur \fIÉTAT\fP est comparée au résultat de la fonction de résolution
appelée par la spécification de service précédente et fait partie des
valeurs suivantes.
.RS 4
.TP 12
\fBsuccess\fP
Aucune erreur ne s'est produite, et la donnée demandée a été
trouvée. L'action par défaut pour cette condition est « return ».
.TP
\fBnotfound\fP
La résolution a réussi, mais la donnée demandée n'a pas été
trouvée. L'action par défaut pour cette condition est « continue ».
.TP
\fBunavail\fP
Le service est indisponible de manière permanente. Cela peut indiquer que le
fichier nécessaire n'est pas lisible, ou, pour les services réseau, que le
serveur n'est pas disponible ou n'accepte pas les requêtes. L'action par
défaut pour cette condition est « continue ».
.TP
\fBtryagain\fP
Le service est temporairement indisponible. Cela signifie qu'un fichier est
verrouillé ou qu'un serveur ne peut pas actuellement accepter davantage de
connexions. L'action par défaut pour cette condition est « continue ».
.RE
.P
La valeur \fIACTION\fP fait partie des valeurs suivantes.
.RS 4
.TP 12
\fBreturn\fP
Renvoyer un résultat maintenant. Ne pas appeler d'autre fonction de
résolution. Cependant, pour des raisons de compatibilité, si c'est l'action
sélectionnée pour la base de données \fBgroup\fP et l'état \fBnotfound\fP, et que
le fichier de configuration ne contient pas la ligne \fBinitgroups\fP, la
fonction de résolution suivante est toujours appelée sans affecter le
résultat de recherche.
.TP
\fBcontinue\fP
Appeler la fonction de résolution suivante.
.TP
\fBmerge\fP
\fI[SUCCESS=merge]\fP est utilisé entre deux enregistrements de base de
données. Quand un groupe est situé dans le premier des deux enregistrements
de groupe, le traitement continue dans le groupe suivant. Si le groupe est
aussi trouvé dans l’enregistrement suivant (et que le nom de groupe et le
GID correspondent exactement), la liste de membres du second enregistrement
est ajoutée à l’objet de groupe à renvoyer. Disponible depuis la
glibc 2.24. Il est à remarquer que la fusion ne sera pas faite pour
\fBgetgrent\fP(3) et que les membres dupliqués ne seront pas supprimés quand
ils apparaissent dans les deux enregistrements fusionnés.
.RE
.SS "Mode de compatibilité (compat)"
Le service NSS « compat » ressemble à « files », à la différence qu'il
utilise en plus des entrées particulières de \fI/etc/passwd\fP pour permettre
aux utilisateurs ou membres de groupes réseau d'accéder au système. Les
entrées suivantes sont valables dans ce mode.
.RS 4
.P
Pour les bases de données \fBpasswd\fP et \fBshadow\fP :
.RS 4
.TP 12
\fB+\fP\fIutilisateur\fP
Inclure l'\fIutilisateur\fP indiqué depuis la carte passwd/shadow NIS.
.TP
\fB+@\fP\fIgroupe_réseau\fP
Inclure tous les utilisateurs du \fIgroupe_réseau\fP donné.
.TP
\fB\-\fP\fIutilisateur\fP
Exclure l'\fIutilisateur\fP indiqué de la carte passwd/shadow NIS.
.TP
\fB\-@\fP\fIgroupe_réseau\fP
Exclure tous les utilisateurs du \fIgroupe_réseau\fP donné.
.TP
\fB+\fP
Inclure tous les utilisateurs, sauf ceux exclus précédemment, depuis la
carte passwd/shadow NIS.
.RE
.P
Pour la base de données \fBgroup\fP :
.RS 4
.TP 12
\fB+\fP\fIgroupe\fP
Inclure le \fIgroupe\fP indiqué depuis la carte group NIS.
.TP
\fB\-\fP\fIgroupe\fP
Exclure le \fIgroupe\fP indiqué de la carte group NIS.
.TP
\fB+\fP
Inclure tous les utilisateurs, sauf ceux exclus précédemment, depuis la
carte group NIS.
.RE
.RE
.P
La source est « nis » par défaut, mais cela peut être écrasé en indiquant
n’importe quel service NSS excepté « compat » comme source des pseudobases
de données \fBpasswd_compat\fP, \fBgroup_compat\fP et \fBshadow_compat\fP.
.SH FICHIERS
Un service appelé \fISERVICE\fP est implémenté par une bibliothèque objet
partagée appelée \fIlibnss_SERVICE.so.\fP\fBX\fP qui se trouve dans \fI/lib\fP.
.RS 4
.TP 25
.PD 0
\fI/etc/nsswitch.conf\fP
fichier de configuration de NSS.
.TP
\fI/lib/libnss_compat.so.\fP\fBX\fP
implémente la source « compat ».
.TP
\fI/lib/libnss_db.so.\fP\fBX\fP
implémente la source « db ».
.TP
\fI/lib/libnss_dns.so.\fP\fBX\fP
implémente la source « dns ».
.TP
\fI/lib/libnss_files.so.\fP\fBX\fP
implémente la source « files ».
.TP
\fI/lib/libnss_hesiod.so.\fP\fBX\fP
implémente la source « hesoid ».
.TP
\fI/lib/libnss_nis.so.\fP\fBX\fP
implémente la source « nis ».
.TP
\fI/lib/libnss_nisplus.so.\fP\fBX\fP
implémente la source « nisplus ».
.PD
.RE
.P
Les fichiers suivants sont lus quand la source « files » est spécifiée pour
leurs bases de données respectives :
.RS 4
.TP 12
.PD 0
\fBaliases\fP
\fI/etc/aliases\fP
.TP
\fBethers\fP
\fI/etc/ethers\fP
.TP
\fBgroup\fP
\fI/etc/group\fP
.TP
\fBhosts\fP
\fI/etc/hosts\fP
.TP
\fBinitgroups\fP
\fI/etc/group\fP
.TP
\fBnetgroup\fP
\fI/etc/netgroup\fP
.TP
\fBnetworks\fP
\fI/etc/networks\fP
.TP
\fBpasswd\fP
\fI/etc/passwd\fP
.TP
\fBprotocols\fP
\fI/etc/protocols\fP
.TP
\fBpublickey\fP
\fI/etc/publickey\fP
.TP
\fBrpc\fP
\fI/etc/rpc\fP
.TP
\fBservices\fP
\fI/etc/services\fP
.TP
\fBshadow\fP
\fI/etc/shadow\fP
.PD
.RE
.SH NOTES
.\" https://sourceware.org/bugzilla/show_bug.cgi?id=12459
À partir de la glibc 2.33, \fBnsswitch.conf\fP est automatiquement rechargé si
le fichier est modifié. Dans les versions précédentes, le fichier n'était lu
en entier qu'une seule fois dans chaque processus. Si le fichier était
modifié par la suite, le processus continuait d'utiliser l'ancienne
configuration.
.P
À l'origine, il n'y avait qu'une seule source pour les renseignements de
service, souvent sous forme d'un simple fichier de configuration (par
exemple, \fI/etc/passwd\fP). Cependant, puisque d'autres services de noms,
comme NIS (« Network Information Service ») et DNS (« Domain Name Service »)
étaient devenus populaires, une méthode plus flexible était devenue
nécessaire pour corriger les ordres de recherche codés dans la
bibliothèque C. Le mécanisme NSS (« Name Service Switch »), qui était basé
sur le mécanisme utilisé par Sun Microsystems dans la bibliothèque C de
Solaris 2, a introduit une solution plus propre au problème.
.SH "VOIR AUSSI"
\fBgetent\fP(1), \fBnss\fP(5)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess ,
Stéphan Rafin ,
Thierry Vignaud ,
François Micaux,
Alain Portal ,
Jean-Philippe Guérard ,
Jean-Luc Coulon (f5ibh) ,
Julien Cristau ,
Thomas Huriaux ,
Nicolas François ,
Florentin Duneau ,
Simon Paillard ,
Denis Barbier ,
David Prévot
et
Jean-Paul Guillonneau
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .