hesiod_getpwnam

HESIOD(3)							    HESIOD(3)



NAME
       hesiod_getpwnam,	 hesiod_getpwuid,  hesiod_free_passwd  - Hesiod func-
       tions 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 infor-
       mation using Hesiod.  To perform lookups, you need an initialized Hes-
       iod context; see hesiod(3) for details.	You may look up passwd infor-
       mation  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)