Provided by: manpages-pt-dev_20040726-4_all bug

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)