Provided by: manpages-pt-dev_20040726-4_all bug

NOME
       getgrent, setgrent, endgrent - Retorna informacoes sobre os grupos


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

       struct group *getgrent(void);

       void setgrent(void);

       void endgrent(void);


DESCRI,C~AO
       A  funcao  getgrent()  um  ponteiro  para  uma  estrutura que contem as
       informacoes dos grupos que estao no arquivo /etc/group.  A primeira vez
       que  a funcao e chamada , ela retorna a primeira entrada do arquivo ; a
       partir dai , retorna as entradas sucessivas.

       A funcao setgrent() retorna o ponteiro do  arquivo  para  o  inicio  de
       /etc/group.

       A funcao endgrent() fecha o arquivo /etc/group.

       A estrutura group esta 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  funcao getgrent() retorna a estrutura com a informacao dos grupos ou
       NULL se nao houver mais entradas no arquivo ou se ocorrer um erro.


ERROS
       ENOMEM Memoria insuficiente para alocar a estrutura de  informacao  dos
              grupos.


ARQUIVOS
       /etc/group
               Arquivo de base de dados dos grupos


EM CONFORMIDADE COM
       SVID 3, BSD 4.3


VER TAMB'EM
       fgetgrent(3), getgrnam(3), getgrgid(3)


TRADU,C~AO PARA A L'INGUA PORTUGUESA
       Antonio Belloni <abelloni@ig.com.br> (traducao)