Manualshelf

getpwent.3c (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
g
getpwent(3C) getpwent(3C)
NAME
getpwent(), getpwuid(), getpwuid_r(), getpwnam(), getpwnam_r(), setpwent(), endpwent(), fgetpwent() -
get password file entry
SYNOPSIS
#include <pwd.h>
struct passwd *getpwent(void);
struct passwd *getpwuid(uid_t uid);
int getpwuid_r(uid_t uid, struct passwd *pwd, char *buffer,
size_t buflen, struct passwd **result);
struct passwd *getpwnam(const char *name);
int getpwnam_r(char *name, struct passwd *pwd, char *buffer,
size_t buflen, struct passwd **result);
void setpwent(void);
void endpwent(void);
struct passwd *fgetpwent(FILE *stream);
Obsolescent Interfaces
#include <pwd.h>
int getpwent_r(struct passwd *result, char *buffer, int buflen,
FILE **pwfp);
void setpwent_r(FILE **pwfp);
void endpwent_r(FILE **pwfp);
int fgetpwent_r(FILE *f, struct passwd *result, char *buffer,
int buflen);
DESCRIPTION
getpwent(), getpwuid(), and getpwnam() are used to obtain password entries, and return a
pointer to an object of passwd structure. An entry may come from any of the sources for
passwd
specified in the /etc/nsswitch.conf
file. See nsswitch.conf(4).
The
passwd structure is defined in <pwd.h> and includes the following members:
char *pw_name; /* user name */
char *pw_passwd; /* encrypted password */
uid_t pw_uid; /* user id */
gid_t pw_gid; /* group id */
char *pw_age; /* password aging */
char *pw_comment; /* unused */
char *pw_gecos; /* user fullname, office, extension, homephone*/
char *pw_dir; /* initial directory */
char *pw_shell; /* initial shell */
aid_t pw_audid; /* numerical audit id */
int pw_audflg; /* numerical audit flag */
The pw_comment field is unused. For more information on the other fields, see the passwd (4) manpage.
getpwent() When first called, getpwent() returns a pointer to the first passwd structure in
the password database. Thereafter, it returns a pointer to the next passwd struc-
ture in the database.
setpwent() Has the effect of rewinding the password database to allow repeated searches.
endpwent() Can be called to indicate that password database processing is complete.
getpwuid() Searches from the beginning of the password database until a numeric user ID
matching uid is found, and returns a pointer to the particular structure in which it
was found.
getpwnam() Searches from the beginning of the password database until a login name matching
name is found, and returns a pointer to the particular structure in which it was
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)