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 [AT] ig.br> (tradução)