setnetgrent

Autres langues

Langue: fr

Version: 20 août 2002 (manpagesfr.free.fr - 07/08/07)

Section: 3 (Bibliothèques de fonctions)

NOM

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

SYNOPSIS

#include <netdb.h>

int setnetgrent(const char *groupe_réseau);
void endnetgrent(void);
int getnetgrent(char **hôte, char **utilisateur, char **domaine);

int getnetgrent_r(char **hôte, char **utilisateur, char **domaine, char *tampon, int longueur_tampon);

int innetgr(const char *groupe_réseau, const char *hôte, const char *utilisateur, const char *domaine);

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 la base dans laquelle on effectue les recherches.

L'appel setnetgrent() définit le « groupe_réseau Â» dans lequel on cherchera par un appel getnetgrent() ultérieur. 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 valides 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 enregistrent 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.

FICHIERS

/etc/netgroup
/etc/nsswitch.conf

VALEURS RENVOYÉES

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

NOTES

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

VOIR AUSSI

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

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 12 mai 2006 et révisée le 7 décembre 2006.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 setnetgrent Â». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.