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

NOMBRE

       fgetpwent - obtiene una entrada de un fichero de contrasenas

SINOPSIS

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

       struct passwd *fgetpwent(FILE *flujo);

DESCRIPCI'ON

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

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

              struct passwd {
                      char    *pw_name;       /* nombre de usuario */
                      char    *pw_passwd;     /* contrasena del usuario */
                      uid_t   pw_uid;         /* identificacion del usuario */
                      gid_t   pw_gid;         /* identificacion del grupo */
                      char    *pw_gecos;      /* nombre real */
                      char    *pw_dir;        /* directorio inicial */
                      char    *pw_shell;      /* programa `shell' */
              };

VALOR DEVUELTO

       La funcion fgetpwent() devuelve la direccion de una estructura  passwd,
       o NULL si no hay mas 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'EASE TAMBI'EN

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