GETGRNAM(3)

NOME
getgrnam, getgrgid - obtêm uma entrada do arquivo gropo

SINÓPSE
#include <grp.h>
#include <sys/types.h>

struct group *getgrnam(const char *name);

struct group *getgrgid(gid_t gid);

DESCRIÇÃO
A função getgrnam() retorna um ponteiro para uma estrutura contendo a informação de grupo de /etc/group para a entrada que casar com o nome do grupo name.

A função getgrgid() retorna um ponteiro para uma estrutura contendo a informação de grupo de /etc/group para a entrada que casa com o gid do grupo gid.

A estrutura group está definida em <grp.h> como segue:

    struct group {
            char    *gr_name;        /* nome do grupo */
            char    *gr_passwd;      /* senha do grupo */
            gid_t   gr_gid;          /* id do grupo */
            char    **gr_mem;        /* membros do grupo */
    };

VALORES RETORNADOS
As funções getgrnam() e getgrgid() retornam a estrutura de informação do grupo, ou NULO se a entrada não é encontrada ou um se ocorre um erro.

ERROS

ENOMEM
    Memória insuficiente para alocar a estrutura de informação de grupo.

ARQUIVOS

/etc/group
    Arquivo do banco de dados de grupo.

DE ACORDO COM
SVID 3, POSIX, BSD 4.3.

VEJA TAMBÉM
fgetgrent(3), getgrent(3), setgrent(3), endgrent(3).

TRADUZIDO POR LDP-BR em 28/05/2001.

  Tradução:
Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>

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