GETGRENT(3)

NOME
getgrent, setgrent, endgrent - obtêm informações sobre os grupos

SINÓPSE
#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 */
    };

VALORES RETORNADOS
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

DE ACORDO COM
SVID 3, BSD 4.3

VEJA TAMBÉM
fgetgrent(3), getgrnam(3), getgrgid(3).

TRADUZIDO POR LDP-BR em 21/08/2000.

  Tradução:
Antonio Belloni <abelloni@ig.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>