NOME

       getgrent, setgrent, endgrent - Retorna informações sobre os grupos

SINOPSE

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

       struct group *getgrent(void);

       void setgrent(void);

       void endgrent(void);

DESCRIÇÃO

       A  função  getgrent()  um ponteiro para uma estrutura que contém as informações dos grupos
       que estão no arquivo /etc/group.  A primeira vez que a função é chamada ,  ela  retorna  a
       primeira entrada do arquivo ; a partir daí , retorna as entradas sucessivas.

       A função setgrent() retorna o ponteiro do arquivo para o início de /etc/group.

       A função endgrent() fecha o arquivo /etc/group.

       A estrutura group está definida em <grp.h> conforme abaixo:

              struct group {
                      char    *gr_name;        /* group name */
                      char    *gr_passwd;      /* group password */
                      gid_t   gr_gid;          /* group id */
                      char    **gr_mem;        /* group members */
              };

VALOR RETORNADO

       A  função getgrent() retorna a estrutura com a informação dos grupos ou NULL se não houver
       mais entradas no arquivo ou se ocorrer um erro.

ERROS

       ENOMEM Memória insuficiente para alocar a estrutura de informação dos grupos.

ARQUIVOS

       /etc/group
               Arquivo de base de dados dos grupos

EM CONFORMIDADE COM

       SVID 3, BSD 4.3

VER TAMBÉM

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

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       Antonio Belloni <abelloni@ig.com.br> (tradução)