hesiod_free_postoffice man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

HESIOD(3)							     HESIOD(3)

NAME
       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 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)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net