Provided by: manpages-es_1.55-8_all bug

NOMBRE

       fgetpwent - obtiene una entrada de un fichero de contraseñas

SINOPSIS

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

       struct passwd *fgetpwent(FILE *flujo);

DESCRIPCIÓN

       La  función  fgetpwent()  devuelve  un  puntero  a  una  estructura que
       contiene  los  campos  descompuestos   de   una   línea   del   fichero
       correspondiente  a  flujo.  La  primera vez que se la llama devuelve la
       primera entrada; a partir de ahí, devuelve las entradas  sucesivas.  El
       fichero  que  corresponde  a  flujo  debe  tener  el  mismo formato que
       /etc/passwd.

       La estructura passwd está definida en <pwd.h> como sigue:

              struct passwd {
                      char    *pw_name;       /* nombre de usuario */
                      char    *pw_passwd;     /* contraseña del usuario */
                      uid_t   pw_uid;         /* identificación del usuario */
                      gid_t   pw_gid;         /* identificación del grupo */
                      char    *pw_gecos;      /* nombre real */
                      char    *pw_dir;        /* directorio inicial */
                      char    *pw_shell;      /* programa ‘shell’ */
              };

VALOR DEVUELTO

       La función fgetpwent() devuelve la dirección de una estructura  passwd,
       o NULL si no hay más entradas o si ha ocurrido un error.

ERRORES

       ENOMEM Memoria insuficiente para alojar la estructura passwd.

FICHEROS

       /etc/passwd
              fichero con los datos de los usuarios

CONFORME A

       SVID 3

VÉASE TAMBIÉN

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