hesiod_getpwnam, hesiod_getpwuid, hesiod_free_passwd - Hesiod functions for retrieving passwd information
Contents
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.
Errors
These calls may fail for any of the reasons the routine hesiod_resolve may fail.
Name
hesiod_getpwnam, hesiod_getpwuid, hesiod_free_passwd - Hesiod functions for retrieving passwd information
Return Values
On failure, hesiod_getpwnam and hesiod_getpwuid return NULL and set the global variable errno to indicate
the error.
See Also
hesiod(3) 30 November 1996 HESIOD(3)
Synopsis
#include<hesiod.h>structpasswd*hesiod_getpwnam(void*context,constchar*name)structpasswd*hesiod_getpwuid(void*context,uid_tuid)voidhesiod_free_passwd(void*context,structpasswd*pw)ccfile.c-lhesiod
