home | help
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 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 getp-
     wuid.  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  representa-
     tion  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)

home | help