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

NOMBRE
       getpwent,  setpwent,  endpwent  -  obtiene  una  entrada del fichero de
       cuentas de usuario


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

       struct passwd *getpwent(void);

       void setpwent(void);

       void endpwent(void);


DESCRIPCI'ON
       La funcion getpwent() devuelve un puntero a una estructura que contiene
       los  campos de una linea de /etc/passwd. La primera vez que se la llama
       devuelve la primera entrada; a partir de  ahi,  devuelve  las  entradas
       sucesivas.

       La  funcion  setpwent()  rebobina  el indicador de posicion del fichero
       para ponerlo apuntando al principio de /etc/passwd.

       La funcion endpwent() cierra el fichero /etc/passwd.

       La estructura passwd se define en <pwd.h> como sigue:

              struct passwd {
                      char    *pw_name;       /* nombre de usuario */
                      char    *pw_passwd;     /* contrasena cifrada */
                      uid_t   pw_uid;         /* id. del usuario */
                      gid_t   pw_gid;         /* id. del grupo primario */
                      char    *pw_gecos;      /* nombre real */
                      char    *pw_dir;        /* directorio de inicio */
                      char    *pw_shell;      /* programa caparazon */
              };


VALOR DEVUELTO
       La funcion getpwent() devuelve la estructura passwd, o NULL si  no  hay
       mas entradas u ocurre un error.


ERRORES
       ENOMEM Memoria insuficiente para alojar la estructura passwd.


FICHEROS
       /etc/passwd
              fichero con los datos de las cuentas de usuario


CONFORME A
       SVID 3, BSD 4.3


V'EASE TAMBI'EN
       fgetpwent(3),    getpwnam(3),   getpwuid(3),   getpw(3),   putpwent(3),
       passwd(5).