Fonctions
des bibliothèques (section 3) getgrgid
Nom
getgrnam, getgrgid - Obtenir l'enregistrement d'un goupe.Synopsis
#include <grp.h>#include <sys/types.h> struct group *getgrnam (const char *name); struct group *getgrgid (gid_t gid);
Description
La fonction getgrnam() renvoie un pointeur sur structure contenant l'enregistrement issus de /etc/group pour le groupe correspondant au nom name.La fonction getgrnid() renvoie un pointeur sur structure contenant l'enregistrement issus de /etc/group pour le groupe correspondant a l'ID gid.
La structure group est définie dans <grp.h> ainsi :
struct group { char *gr_name; /* Nom du groupe. */ char *gr_passwd; /* Mot de passe du groupe. */ gid_t gr_gid; /* ID du groupe. */ char **gr_mem; /* Membres du groupe. */ };
Valeur Renvoyée
Les fonctions getgrnam() et getgrgid() renvoient la structure
de groupe, ou NULL s'il n'y a pas de groupe correspondant aux données, ou
si une erreur se produit.
Erreurs
- ENOMEM
- Pas assez de mémoire pour allouer la structure.
Fichiers
- /etc/group
- Base de données des groupes.
Conformité
SVID 3, POSIX, BSD 4.3Voir Aussi
fgetgrent(3) , getgrent(3) , setgrent(3) , endgrent(3) .
Traduction
Christophe Blaess, 1997.