getgrnam(3) Library Functions Manual getgrnam(3) NOM getgrnam, getgrnam_r, getgrgid, getgrgid_r - Obtenir l'enregistrement d'un groupe BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include #include struct group *getgrnam(const char *name); struct group *getgrgid(gid_t gid); int getgrnam_r(const char *restrict name, struct group *restrict grp, char buf[restrict .buflen], size_t buflen, struct group **restrict result); int getgrgid_r(gid_t gid, struct group *restrict grp, char buf[restrict .buflen], size_t buflen, struct group **restrict result); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : getgrnam_r(), getgrgid_r() : _POSIX_C_SOURCE || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE DESCRIPTION La fonction getgrnam() renvoie un pointeur vers une structure contenant les champs de l'enregistrement de la base de donnees de groupe (par exemple, le fichier de groupes local /etc/group, NIS, et LDAP) correspondant au nom name. La fonction getgrgid() renvoie un pointeur vers une structure contenant les champs de l'enregistrement de la base de donnees de groupe correspondant au GID gid. La structure group est definie dans comme ceci : struct group { char *gr_name; /* nom de groupe */ char *gr_passwd; /* mot de passe de groupe */ gid_t gr_gid; /* identifiant de groupe */ char **gr_mem; /* tableau de pointeurs de nom des membres de groupe termine par un pointeur NULL */ }; Pour plus d'informations a propos des champs de cette structure, consultez group(5). Les fonctions getgrnam_r() et getgrgid_r() fournissent la meme information que getgrnam() et getgrgid() mais enregistrent la structure group trouvee dans l'espace pointe par grp. Cette structure group contient des pointeurs vers des chaines de caracteres qui sont enregistrees dans le tampon buf de taille buflen. Un pointeur vers le resultat (en cas de succes) ou NULL (au cas ou aucune entree n'ait ete trouvee ou qu'une erreur soit survenue) est enregistre dans *result. L'appel sysconf(_SC_GETGR_R_SIZE_MAX) renvoie soit -1 sans modifier errno, soit une suggestion de taille initiale pour buf (si cette taille est trop petite, l'appel echoue avec ERANGE, auquel cas l'appelant peut reessayer avec un tampon plus grand). VALEUR RENVOYEE Les fonctions getgrnam() et getgrgid() renvoient un pointeur vers une structure group, ou NULL s'il n'y a pas de correspondance, ou si une erreur se produit. Dans ce cas, errno est defini pour indiquer l'erreur. Si on souhaite verifier errno apres l'appel, il devrait etre positionne a zero avant l'appel. La valeur de retour peut pointer sur une zone de memoire statique et peut etre ecrasee par des appels successifs a getgrent(3), getgrgid() ou getgrnam(). (Ne pas passer le pointeur renvoye a free(3).) En cas de succes, getgrnam_r() et getgrgid_r() renvoient 0, et definissent *result a grp. Si aucun enregistrement de groupe de correspondance est trouve, ces fonctions renvoient 0 et definissent *result a NULL. En cas d'erreur, un numero d'erreur est renvoye et *result est defini a NULL. ERREURS 0 ou ENOENT ou ESRCH ou EBADF ou EPERM ou ... Le nom name ou l'identifiant gid n'ont pas ete trouves. EINTR Un signal a ete intercepte ; consultez signal(7). EIO Erreur d'entree-sortie. EMFILE La limite du nombre de descripteurs de fichiers par processus a ete atteinte. ENFILE La limite du nombre total de fichiers ouverts pour le systeme entier a ete atteinte. ENOMEM Pas assez de memoire pour allouer la structure group. ERANGE L'espace tampon fourni est insuffisant. FICHIERS /etc/group Base de donnees des groupes locaux ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +--------------+--------------------------+----------------------------+ |Interface | Attribut | Valeur | +--------------+--------------------------+----------------------------+ |getgrnam() | Securite des threads | MT-Unsafe race:grnam | | | | locale | +--------------+--------------------------+----------------------------+ |getgrgid() | Securite des threads | MT-Unsafe race:grgid | | | | locale | +--------------+--------------------------+----------------------------+ |getgrnam_r(), | Securite des threads | MT-Safe locale | |getgrgid_r() | | | +--------------+--------------------------+----------------------------+ VERSIONS La description << VALEUR RENVOYEE >> ci-dessus provient de POSIX.1. Elle ne considere pas le cas << non trouve >> comme une erreur et ne specifie pas errno dans ce cas. Cela rend la detection d'erreur impossible. On peut dire que, d'apres POSIX, errno est inchange dans le cas ou aucune entree n'est trouvee. Des essais sur de nombreux systemes UNIX ont fait apparaitre differentes valeurs dans ce cas : 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM et probablement d'autres. STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001, SVr4, 4.3BSD. VOIR AUSSI endgrent(3), fgetgrent(3), getgrent(3), getpwnam(3), setgrent(3), group(5) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier et David Prevot Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 getgrnam(3)