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)