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).

GNU                                               17 mayo 1996                                      FGETPWENT(3)