HESIOD(3)						     Library Functions Manual							 HESIOD(3)

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 Hes-
       iod 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 repre-
       sentation  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)