GETPWENT(3)

NOME
getpwent, setpwent, endpwent - obtém entrada do arquivo de senha

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

struct passwd *getpwent(void);

void setpwent(void);

void endpwent(void);

DESCRIÇÃO
A função getpwent() retorna um ponteiro para uma estrutura contendo os campos já separados de uma linha de /etc/passwd. A primeira vez que ela é chamada ela retorna a primeira entrada; depois disso, ela retorna entradas sucessivas.

A função setpwent() retrocede o ponteiro do arquivo /etc/passwd para o início.

A função endpwent() fecha o arquivo /etc/passwd.

A estrutura passwd está 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 getpwent() retorna a estrutura passwd, ou NULL se não há mais entradas ou um erro ocorre.

ERROS

ENOMEM
    Memória insuficiente para alocar a estrutura passwd.

ARQUIVOS

/etc/passwd
    arquivo do banco de dados de senhas

DE ACORDO COM
SVID 3, BSD 4.3.

VEJA TAMBÉM
fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd(5).

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>