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)

GNU                                            17 de maio de 1996                                   FGETPWENT(3)