HESIOD(3)						     Library Functions Manual							 HESIOD(3)

NAME

       hesiod_getmailhost, hesiod_free_postoffice - Hesiod functions for retrieving user to postoffice mappings

SYNOPSIS

       #include <hesiod.h>

       struct hesiod_postoffice *hesiod_getmailhost(void *context,
	    const char *user)
       void hesiod_free_postoffice(void *context,
	    struct hesiod_postoffice *po)

       cc file.c -lhesiod

DESCRIPTION

       This family of functions allows you to retrieve user to postoffice mappings using Hesiod.  To perform lookups, you need an initialized Hes-
       iod context; see hesiod(3) for details.	Information is returned in a hesiod_postoffice structure, which has the following fields:

       hesiod_po_type
	      The type of postoffice box, typically ``POP''.

       hesiod_po_host
	      The hostname where the postoffice box resides.

       hesiod_po_name
	      The account name on the given postoffice server.

       It is the caller's responsibility to call hesiod_free_postoffice with the returned postoffice entry to  free  the  resources  used  by  the
       postoffice entry.

       Hesiod queries for postoffice information are made using the ``pobox'' Hesiod type, using the username as the Hesiod name.  The correspond-
       ing entries should be space-separated lists of strings giving the type of postoffice box, the hostname, and the account name.

RETURN VALUES

       On failure, hesiod_getservbyname returns NULL and sets the global variable errno to indicate the error.

ERRORS

       hesiod_getmailhost may fail for any of the reasons the routine hesiod_resolve may fail.

SEE ALSO

       hesiod(3)

								 30 November 1996							 HESIOD(3)