.TH GETGRENT 3  "4 de Abril 1993" "GNU" "Manual do Prgramador Linux"
.SH NOME
getgrent, setgrent, endgrent \- Retorna informações sobre os grupos
.SH SINOPSE
.nf
.B #include <grp.h>
.B #include <sys/types.h>
.sp
.B struct group *getgrent(void);
.sp
.B void setgrent(void);
.sp
.B void endgrent(void);
.fi
.SH DESCRIÇÃO
A função \fBgetgrent()\fP um ponteiro para uma estrutura que contém
as informações dos grupos que estão no arquivo \fI/etc/group\fP.  A primeira
vez que a função é chamada , ela retorna a primeira entrada do arquivo ; a 
partir daí , retorna as entradas sucessivas.
.PP
A função \fBsetgrent()\fP retorna o ponteiro do arquivo para o início de 
\fI/etc/group\fP.
.PP
A função \fBendgrent()\fP fecha o arquivo \fI/etc/group\fP.
.PP
A estrutura \fIgroup\fP está definida em \fI<grp.h>\fP conforme abaixo:
.sp
.RS
.nf
.ta 8n 16n 32n
struct group {
        char    *gr_name;        /* group name */
        char    *gr_passwd;      /* group password */
        gid_t   gr_gid;          /* group id */
        char    **gr_mem;        /* group members */
};
.ta
.fi
.RE
.SH "VALOR RETORNADO"
A função \fBgetgrent()\fP retorna a estrutura com a informação dos grupos
ou NULL se não houver mais entradas no arquivo ou se ocorrer um erro.
.SH ERROS
.TP
.B ENOMEM
Memória insuficiente para alocar a estrutura de informação dos grupos.
.SH ARQUIVOS 
.TP
.I /etc/group
 Arquivo de base de dados dos grupos
.SH "EM CONFORMIDADE COM"
SVID 3, BSD 4.3
.SH "VER TAMBÉM"
.BR fgetgrent "(3), " getgrnam "(3), " getgrgid (3)
.SH "TRADUÇÃO PARA A LÍNGUA PORTUGUESA"
\&\fR\&\f(CWAntonio Belloni <abelloni@ig.com.br> (tradução)\fR