hesiod_getmailhost man page

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 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.

See Also

hesiod(3)

Referenced By

hesiod_free_postoffice(3) is an alias of hesiod_getmailhost(3).

30 November 1996