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
