NOM

       setnetgrent,  endnetgrent,  getnetgrent,  getnetgrent_r,  innetgr  -  Gérer les entrées du
       groupe réseau

SYNOPSIS

       #include <netdb.h>

       int setnetgrent(const char *netgroup);

       void endnetgrent(void);

       int getnetgrent(char **host, char **user, char **domain);

       int getnetgrent_r(char **host, char **user,
                         char **domain, char *buf, int buflen);

       int innetgr(const char *netgroup, const char *host,
                   const char *user, const char *domain);

   Exigences   de   macros   de   test   de   fonctionnalités   pour    la    glibc    (consultez
   feature_test_macros(7)) :

       setnetgrent(), endnetgrent(), getnetgrent(), getnetgrent_r(), innetgr() : _BSD_SOURCE ||
       _SVID_SOURCE

DESCRIPTION

       Le groupe_réseau est une invention SunOS. Une base de données  « groupe_réseau »  est  une
       liste  de  triplets  de  chaînes (nom_hôte, nom_utilisateur, nom_domaine) ou d'autres noms
       « groupe_réseau ». Chacun des éléments dans un triplet peut être vide, ce qui signifie que
       tout  correspond.  Les  fonctions  décrites  ici permettent d'accéder aux bases de données
       « groupe_réseau ». Le fichier  /etc/nsswitch.conf  contient  la  base  dans  laquelle  les
       recherches sont effectuées.

       L'appel  setnetgrent()  définit  le  « groupe_réseau »  dans lequel un appel getnetgrent()
       ultérieur sera recherché. La  fonction  getnetgrent()  trouve  l'entrée  « groupe_réseau »
       suivante et renvoie des pointeurs sur hôte, utilisateur, domaine. Un pointeur nul signifie
       que l'entrée correspondante ne concorde avec aucune chaîne. Les  pointeurs  sont  valables
       tant  qu'il  n'y  a  pas d'appel à d'autres fonctions relatives au « groupe_réseau ». Pour
       éviter ce problème, vous pouvez utiliser la fonction GNU  getnetgrent_r()  qui  enregistre
       les  chaînes  dans  le  tampon  fourni.  Pour  libérer  tous les tampons alloués, utilisez
       endnetgrent().

       Dans la plupart des  cas,  vous  voudrez  seulement  vérifier  si  le  triplet  (nom_hôte,
       nom_utilisateur,  nom_domaine)  est  membre d'un groupe réseau. La fonction innetgr() peut
       être utilisée pour faire cela  sans  faire  appel  aux  trois  fonctions  précédentes.  De
       nouveau,  un  pointeur  nul est un joker (Ndt : wildcard) et correspond à n'importe quelle
       chaîne. La fonction est sûre du point de vue des threads.

VALEUR RENVOYÉE

       Ces fonctions renvoient 1 si elles réussissent et 0 si elles échouent.

FICHIERS

       /etc/netgroup
       /etc/nsswitch.conf

CONFORMITÉ

       Ces  fonctions  ne  sont  pas  dans  POSIX.1-2001,  mais   setnetgrent(),   endnetgrent(),
       getnetgrent()   et   innetgr()   sont  disponibles  sur  la  plupart  des  systèmes  UNIX.
       getnetgrent_r() n'est pas très répandu sur les autres systèmes.

NOTES

       Dans l'implémentation BSD, setnetgrent() renvoie void.

VOIR AUSSI

       sethostent(3), setprotoent(3), setservent(3)

COLOPHON

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

       Alain Portal <http://manpagesfr.free.fr/> (2006). Nicolas François et l'équipe francophone
       de traduction de Debian (2006-2009).

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