NAME
hesiod_getpwnam, hesiod_getpwuid, hesiod_free_passwd - Hesiod functions
for retrieving passwd information
SYNOPSIS
#include <hesiod.h>
struct passwd *hesiod_getpwnam(void *context, const char *name)
struct passwd *hesiod_getpwuid(void *context, uid_t uid)
void hesiod_free_passwd(void *context, struct passwd *pw)
cc file.c -lhesiod
DESCRIPTION
This family of functions allows you to retrieve passwd database
information using Hesiod. To perform lookups, you need an initialized
Hesiod context; see hesiod(3) for details. You may look up passwd
information by name or by uid; information is returned in the same
format as by getpwnam or getpwuid. It is the caller’s responsibility
to call hesiod_free_passwd with the returned passwd entry to free the
resources used by the passwd entry.
Hesiod queries for passwd information are made using the ‘‘passwd’’ or
‘‘uid’’ Hesiod type, using either the username or the decimal
representation of the uid as the Hesiod name. The corresponding
records should be a colon-separated list of fields giving the username,
encrypted password, uid, gid, GECOS information, home directory, and
shell of the user.
RETURN VALUES
On failure, hesiod_getpwnam and hesiod_getpwuid return NULL and set the
global variable errno to indicate the error.
ERRORS
These calls may fail for any of the reasons the routine hesiod_resolve
may fail.
SEE ALSO
hesiod(3)
30 November 1996 HESIOD(3)