Manpages

NOME

fgetpwent − obtém a entrada de arquivo de senha

SINOPSE

#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’ */
};

VALOR DE RETORNO

A função fgetpwent() retorna a estrutura ’passwd’, ou NULL 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

CONFORME

SVID 3

VEJA TAMBÉM

getpwnam(3), getpwuid(3), getpwent(3), setpwent(3), endpwent(3), getpw(3), putpwent(3), passwd(5).

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

RUBENS DE JESUS NOGUEIRA <darkseid99 [AT] usa.net> (tradução) XXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx [AT] xxx.xxx> (revisão)