NOME

       fgetpwent - obtém a entrada de arquivo de senha

BIBLIOTECA

       Biblioteca C Padrão (libc, -lc)

SINOPSE

       #include <stdio.h>
       #include <sys/types.h>
       #include <pwd.h>

       struct passwd *fgetpwent(FILE *fluxo);

   Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

       fgetpwent():
           Desde o glibc 2.19:
               _DEFAULT_SOURCE
           glibc 2.19 e anterior:
               _SVID_SOURCE

DESCRIÇÃO

       A  função fgetpwent() retorna um ponteiro para uma estrutura contendo os campos quebrados 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 arquivo referenciado por fluxo deve ter o mesmo formato que /etc/passwd
       (consulte passwd(5)).

       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 home */
               char    *pw_shell;       /* programa de shell */
           };

VALOR DE RETORNO

       A função fgetpwent() retorna um ponteiro para uma estrutura passwd, ou NULO se não houver mais  entradas,
       ou se ocorrer um erro. No evento de um erro, errno é definido para indicar o erro.

ERROS

       ENOMEM Memória insuficiente para alocar a estrutura passwd.

ARQUIVOS

       /etc/passwd
              arquivo de banco de dados de senha.

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).
       ┌────────────────────────────────────────────────────────────┬───────────────┬──────────────────────────┐
       │ Interface                                                  │ Atributo      │ Valor                    │
       ├────────────────────────────────────────────────────────────┼───────────────┼──────────────────────────┤
       │ fgetpwent()                                                │ Thread safety │ MT-Unsafe race:fgetpwent │
       └────────────────────────────────────────────────────────────┴───────────────┴──────────────────────────┘

PADRÕES

       Nenhum.

HISTÓRICO

       SVr4.

VEJA TAMBÉM

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

TRADUÇÃO

       A tradução para  português  brasileiro  desta  página  man  foi  criada  por  Rubens  de  Jesus  Nogueira
       <darkseid99@usa.net>,    André    Luiz    Fassone    <lonely_wolf@ig.com.br>    e    Rafael    Fontenelle
       <rafaelff@gnome.org>.

       Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou  posterior  para  as
       condições de direitos autorais.  Nenhuma responsabilidade é aceita.

       Se  você  encontrar  algum  erro  na  tradução  desta  página  de manual, envie um e-mail para a lista de
       discussão de tradutores.

Linux man-pages 6.9.1                              2 maio 2024                                      fgetpwent(3)