FreeBSD Manual Pages
HESIOD(3) Library Functions Manual HESIOD(3) NAME hesiod_getmailhost, hesiod_free_postoffice - Hesiod functions for re- trieving 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 map- pings using Hesiod. To perform lookups, you need an initialized Hesiod context; see hesiod(3) for details. Information is returned in a hes- iod_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 postof- fice 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 vari- able errno to indicate the error. ERRORS hesiod_getmailhost may fail for any of the reasons the routine hes- iod_resolve may fail. SEE ALSO hesiod(3) 30 November 1996 HESIOD(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hesiod_free_postoffice&sektion=3&manpath=FreeBSD+Ports+15.0>