Linux

CentOS 4.8

getgrnam(3)


GETGRNAM

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

VOIR AUSSI

fgetgrent(3), getgrent(3), setgrent(3), endgrent(3).

TRADUCTION

Christophe Blaess, 1997.


getgrnam(3)