FGETPWENT(3)

NOME
fgetpwent - obtém a entrada de arquivo de senha

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

struct passwd *fgetpwent(FILE *stream);

DESCRIÇÃO
A função fgetpwent() retorna um ponteiro para uma estrutura contendo os campos 'broken out' de uma linha no fluxo de arquivo. Na primeira vez em que ela é chamada, ela retorna a primeira entrada; em seguida, ela retorna entradas sucessivas. O fluxo de arquivo precisa ter o mesmo formato que /etc/passwd.

A estrutura passwd é definida em <pwd.h> como segue:

    struct passwd {
            char    *pw_name;		/* nome do usuário */
            char    *pw_passwd;		/* senha do usuário */
            uid_t   pw_uid;			/* id do usuário */
            gid_t   pw_gid;			/* id do grupo */
            char    *pw_gecos;      	/* nome real */
            char    *pw_dir;  		/* diretório inicial */
            char    *pw_shell;      	/* programa 'shell' */
    };

VALORES RETORNADOS
A função fgetpwent() retorna a estrutura 'passwd', ou NULO se não houver mais entradas, ou se ocorrer um erro.

ERROS

ENOMEM
    Memória insuficiente para alocar a estrutura 'passwd'.

ARQUIVOS

/etc/passwd
    arquivo de banco de dados de senha.

DE ACORDO COM
SVID 3

VEJA TAMBÉM
getpwnam(3), getpwuid(3), getpwent(3), setpwent(3), endpwent(3), getpw(3), putpwent(3), passwd(5).

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

  Tradução:
Rubens de Jesus Nogueira <darkseid99@usa.net>

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