Copyright (C) 2000-2012 |
Manpages HESIODSection: C Library Functions (3)Updated: 30 November 1996 Index Return to Main Contents NAMEhesiod_getmailhost, hesiod_free_postoffice - Hesiod functions for retrieving user to postoffice mappingsSYNOPSIS#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 DESCRIPTIONThis 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:
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 VALUESOn failure, hesiod_getservbyname returns NULL and sets the global variable errno to indicate the error.ERRORShesiod_getmailhost may fail for any of the reasons the routine hesiod_resolve may fail.SEE ALSOhesiod(3)
IndexThis document was created by man2html, using the manual pages. Time: 14:13:36 GMT, March 29, 2024 |