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)