hesiod_getmailhost, hesiod_free_postoffice - Hesiod functions for
retrieving user to postoffice mappings
struct hesiod_postoffice *hesiod_getmailhost(void *context,
const char *user)
void hesiod_free_postoffice(void *context,
struct hesiod_postoffice *po)
cc file.c -lhesiod
This family of functions allows you to retrieve user to postoffice
mappings using Hesiod. To perform lookups, you need an initialized
Hesiod context; see hesiod(3) for details. Information is returned in
a hesiod_postoffice structure, which has the following fields:
The type of postoffice box, typically ‘‘POP’’.
The hostname where the postoffice box resides.
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
Hesiod queries for postoffice information are made using the ‘‘pobox’’
Hesiod type, using the username as the Hesiod name. The corresponding
entries should be space-separated lists of strings giving the type of
postoffice box, the hostname, and the account name.
On failure, hesiod_getservbyname returns NULL and sets the global
variable errno to indicate the error.
hesiod_getmailhost may fail for any of the reasons the routine
hesiod_resolve may fail.
30 November 1996 HESIOD(3)