Provided by: manpages-es_1.55-10_all bug

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'ON
       La funcion getgrent() devuelve un puntero a una estructura que contiene
       la informacion de grupo de  /etc/group.  La primera vez que se la llama
       devuelve la primera entrada; a partir  de  ahi  devuelve  las  entradas
       sucesivas.

       La  funcion setgrent() rebobina el apuntador de posicion del fichero al
       principio del fichero /etc/group.

       La funcion 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;      /* contrasena del grupo */
                      gid_t   gr_gid;          /* id. del grupo */
                      char    **gr_mem;        /* miembros del grupo */
              };


VALOR DEVUELTO
       La funcion getgrent()  devuelve  la  direccion  de  la  estructura  con
       informacion  del  grupo, o NULL si no hay mas entradas o ha ocurrido un
       error.


ERRORES
       ENOMEM No hay bastante memoria como para alojar la  estructura  con  la
              informacion del grupo.


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


CONFORME A
       SVID 3, BSD 4.3


V'EASE TAMBI'EN
       fgetgrent(3), getgrnam(3), getgrgid(3)