hesiod_getmailhost3
Hesiod functions for retrieving user to postoffice mappings
Usage
#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
Overview
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:
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 corresponding 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.
Releases
12 releases since Debian 3.0 (Woody); the text changed 2 times.