Home
March 21, 2010 11:37:39 PM EST
home
back print
HESIOD   (3) manpage
HESIOD
3
30 November 1996
  • 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


Current Users: 82 © 1999-2009 PenguinSoft. All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.