NOMBRE

       getgrent, setgrent, endgrent - obtiene una entrada del fichero de grupos

SINOPSIS

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

       struct group *getgrent(void);

       void setgrent(void);

       void endgrent(void);

DESCRIPCIÓN

       La  función getgrent() devuelve un puntero a una estructura que contiene la información de
       grupo de  /etc/group.  La primera vez que se la  llama  devuelve  la  primera  entrada;  a
       partir de ahí devuelve las entradas sucesivas.

       La  función  setgrent()  rebobina  el  apuntador  de posición del fichero al principio del
       fichero /etc/group.

       La función endgrent() cierra el fichero /etc/group.

       La estructura group se define en <grp.h> como sigue:

              struct group {
                      char    *gr_name;        /* nombre del grupo */
                      char    *gr_passwd;      /* contraseña del grupo */
                      gid_t   gr_gid;          /* id. del grupo */
                      char    **gr_mem;        /* miembros del grupo */
              };

VALOR DEVUELTO

       La función getgrent() devuelve la dirección de la estructura con información del grupo,  o
       NULL si no hay más entradas o ha ocurrido un error.

ERRORES

       ENOMEM No  hay  bastante  memoria  como  para  alojar la estructura con la información del
              grupo.

FICHEROS

       /etc/group
              fichero con la base de datos de grupos

CONFORME A

       SVID 3, BSD 4.3

VÉASE TAMBIÉN

       fgetgrent(3), getgrnam(3), getgrgid(3)