Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       getgrnam,  getgrnam_r,  getgrgid, getgrgid_r - Obtenir l'enregistrement
       d'un groupe

SYNOPSIS

       #include <sys/types.h>
       #include <grp.h>

       struct group *getgrnam(const char *name);

       struct group *getgrgid(gid_t gid);

       int getgrnam_r(const char *name, struct group *grp,
                 char *buf, size_t buflen, struct group **result);

       int getgrgid_r(gid_t gid, struct group *grp,
                 char *buf, size_t buflen, struct group **result);

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

       getgrnam_r(), getgrgid_r() :
           _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
           _SVID_SOURCE || _POSIX_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.

       Les   fonctions   getgrnam_r()   et   getgrgid_r()  cherchent  la  meme
       information mais enregistrent la structure group trouvee dans  l'espace
       pointe  par  grp. Cette structure group contient des pointeurs vers des
       chaines de caracteres et ces chaines 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.

       La structure group est definie dans <grp.h> comme ceci :

           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 */
           };

       La   taille  maximum  necessaire  pour  buf  peut  etre  recuperee  par
       sysconf(3) avec le parametre _SC_GETGR_R_SIZE_MAX.

VALEUR RENVOY'EE

       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 en consequence. 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.

       EIO    Erreur d'entree-sortie.

       EMFILE Le  nombre  maximal  (OPEN_MAX)  de  fichiers  ouverts  par   le
              processus est atteint.

       ENFILE Le  nombre  maximal  de  fichiers  ouverts  sur  le  systeme est
              atteint.

       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

CONFORMIT'E

       SVr4, BSD 4.3, POSIX.1-2001.

NOTES

       La   description   << VALEUR   RENVOYEE >>   ci-dessus   provient    de
       POSIX.1-2001.  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.

VOIR AUSSI

       endgrent(3),   fgetgrent(3),   getgrent(3),  getpwnam(3),  setgrent(3),
       group(5)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue a l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-2006).  Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                                 30 mars 2009                      GETGRNAM(3)