DragonFly On-Line Manual Pages

HESIOD(3)             DragonFly 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 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)