NOM¶
getent - Récupérer des entrées depuis les
bibliothèques NSS
SYNOPSIS¶
getent base_de_données [
clé ...]
DESCRIPTION¶
La commande
getent affiche les entrées des bases de données
prises en charge par les bibliothèques du Name Service Switch (NSS),
qui sont configurées dans
/etc/nsswitch.conf. Si un ou plusieurs
arguments
clé sont fournis, alors seules les entrées
correspondantes aux clés fournies seront affichées. Sinon, si
aucune
clé n'est fournie, toutes les entrées seront
affichées (sauf si la base de données ne permet pas
l'énumération).
La
base_de_données peut être n'importe laquelle des
suivantes, prises en charge par la bibliothèque C de GNU.
- ahosts
- Si aucune clé n'est fournie, utiliser sethostent(3),
gethostent(3) et endhostent(3) pour énumérer
la base de données d'hôtes. C'est identique à
l'utilisation de hosts. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés en
enfilade à getaddrinfo(3) avec la famille d'adresse
AF_UNSPEC, en énumérant chaque structure d'adresse de
socket renvoyée.
- ahostsv4
- Comme ahosts, mais en utilisant la famille d'adresse
AF_INET.
- ahostsv6
- Comme ahosts, mais en utilisant la famille d'adresse
AF_INET6. L'appel à getaddrinfo(3) contient dans ce
cas l'attribut AI_V4MAPPED.
- aliases
- Si aucune clé n'est fournie, utiliser setaliasent(3),
getaliasent(3) et endaliasent(3) pour énumérer
la base de données d'alias. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés en
enfilade à getaliasbyname(3) et afficher le
résultat.
- ethers
- Si un ou plusieurs arguments clé sont fournis, passer toutes
les clés en enfilade à getaliasbyname(3) et
ether_hostton(3) jusqu'à obtention d'un résultat, et
l'afficher. L'énumération n'est pas possible avec
ethers, donc une clé doit être fournie.
- group
- Si aucune clé n'est fournie, utiliser setgrent(3),
getgrent(3) et endgrent(3) pour énumérer la
base de données de groupe. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés
numériques à getgrgid(3) et toutes les
clés non numériques à getgrnam(3), et
afficher le résultat.
- gshadow
- Si aucune clé n'est fournie, utiliser setsgent(3),
getsgent(3) et endsgent(3) pour énumérer la
base de données gshadow. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés en
enfilade à getsgnam(3) et afficher le résultat.
- hosts
- Si aucune clé n'est fournie, utiliser sethostent(3),
gethostent(3) et endhostent(3) pour énumérer
la base de données d'hôtes. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés
à gethostbyaddr(3) ou gethostbyname2(3), suivant si
un appel à inet_pton(3) indique que la clé est
une adresse IPv6, IPv4 ou pas, et afficher le résultat.
- initgroups
- Si un ou plusieurs arguments clé sont fournis, passer toutes
les clés en enfilade à getgrouplist(3) et
afficher le résultat. L'énumération n'est pas
possible avec initgroups, donc une clé doit
être fournie.
- netgroup
- Si une clé est fournie, passer la clé à
setnetgrent(3) et, en utilisant getnetgrent(3), afficher le
triplet chaîne résultat ( nom_d_hôte,
identifiant, nom_de_domaine). Sinon, trois
clés peuvent être fournies,
interprétées comme nom_d_hôte,
identifiant et nom_de_domaine pour correspondre à un
nom de groupe réseau à l'aide de innetgr(3).
L'énumération n'est pas possible avec netgroup, donc
soit une, soit trois clés doivent être fournies.
- networks
- Si aucune clé n'est fournie, utiliser setnetent(3),
getnetent(3) et endnetent(3) pour énumérer la
base de données de réseaux. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés
numériques à getnetbyaddr(3) et toutes les
clés non numériques à getnetbyname(3),
et afficher le résultat.
- passwd
- Si aucune clé n'est fournie, utiliser setpwent(3),
getpwent(3) et endpwent(3) pour énumérer la
base de données de mot de passe. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés
numériques à getpwuid(3) et toutes les
clés non numériques à getpwnam(3), et
afficher le résultat.
- protocols
- Si aucune clé n'est fournie, utiliser setprotoent(3),
getprotoent(3) et endprotoent(3) pour énumérer
la base de données de protocoles. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés
numériques à getprotobynumber(3) et toutes les
clés non numériques à
getprotobyname(3), et afficher le résultat.
- rpc
- Si aucune clé n'est fournie, utiliser setrpcent(3),
getrpcent(3) et endrpcent(3) pour énumérer la
base de données RPC. Si un ou plusieurs arguments clé
sont fournis, passer toutes les clés numériques
à getrpcbynumber(3) et toutes les clés non
numériques à getrpcbyname(3), et afficher le
résultat.
- services
- Si aucune clé n'est fournie, utiliser setservent(3),
getservent(3) et endservent(3) pour énumérer
la base de données de services. Si un ou plusieurs arguments
clé sont fournis, passer toutes les clés
numériques à getservbynumber(3) et toutes les
clés non numériques à getservbyname(3),
et afficher le résultat.
- shadow
- Si aucune clé n'est fournie, utiliser setspent(3),
getspent(3) et endspent(3) pour énumérer la
base de données de mots de passe cachés. Si un ou plusieurs
arguments clé sont fournis, passer toutes les
clés en enfilade à getspnam(3) et afficher le
résultat.
CODE DE RETOUR¶
Un des codes de retour suivants peut être renvoyé par
getent.
- 0
- Commande terminée avec succès.
- 1
- Arguments manquants, ou base_de_données inconnue.
- 2
- Au moins une des clés fournie n'a pas été
trouvée dans la base_de_données.
- 3
- Énumération impossible avec cette
base_de_données.
VOIR AUSSI¶
nsswitch.conf(5)
COLOPHON¶
Cette page fait partie de la publication 3.65 du projet
man-pages Linux.
Une description du projet et des instructions pour signaler des anomalies
peuvent être trouvées à l'adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce
document en utilisant la commande «
man -L C
<section>
<page_de_man> ».
