Man page 1 : getent

getent - Récupérer des entrées depuis les bibliothèques NSS

getent base_de_données [clé ...]

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.

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.

nsswitch.conf(5)

Cette page fait partie de la publication 3.52 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/.

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 à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».