GETPWENT(3)
NAME
getpwent, getpwuid, getpwnam, setpwent, endpwent − get password file entry
USAGE
#include <pwd.h>
struct passwd *getpwent()
struct passwd *getpwuid(uid) int uid;
struct passwd *getpwnam(name) char *name;
int setpwent()
int endpwent()
DESCRIPTION
Getpwent, getpwuid and getpwnam each return a pointer to an object with the following structure. It contains the broken-out fields of a line in the password file. struct passwd { /* see getpwent(3) */ char *pw_name; char *pw_passwd; int pw_uid; int pw_gid; int pw_quota; char *pw_comment; char *pw_gecos; char *pw_dir; char *pw_shell; };
struct passwd *getpwent(), *getpwuid(), *getpwnam(); The fields pw_quota and pw_comment are unused. The rest are described in the manual entry for passwd(5).
Getpwent reads the next line (opening the file if necessary); setpwent rewinds the file; endpwent closes it.
Getpwuid and getpwnam search /etc/passwd from the beginning until a matching uid or name is found (or until EOF is encountered).
NOTES
All information is contained in a static area so it must be copied if it is to be saved.
On DOMAIN/IX Systems, /etc/passwd is built from registry information by the program crpasswd(8).
DIAGNOSTICS
Null pointer (zero) returned on EOF or error.
FILES
/etc/passwd the password file