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@usa.net>  (tradução)  XXXXXX  XX  XXXXX  XXXXXXXX
       <xxxxxxxxxx@xxx.xxx> (revisão)