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
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)