hesiod.conf(5) [freebsd man page]

HESIOD.CONF(5)							File Formats Manual						    HESIOD.CONF(5)

NAME

       hesiod.conf - Configuration file for the Hesiod library

DESCRIPTION

       The file hesiod.conf determines the behavior of the Hesiod library.  Blank lines and lines beginning with a `#' character are ignored.  All
       other lines should be of the form variable = value, where the value should be a single word.  Possible variables and values are:

       lhs    Specifies the domain prefix used for Hesiod queries.  In almost all cases, you should specify ``lhs=.ns''.  The default value if you
	      do not specify an lhs value is no domain prefix, which is not compatible with most Hesiod domains.

       rhs    Specifies  the  default Hesiod domain; this value may be overridden by the HES_DOMAIN environment variable.  You must specify an rhs
	      line for the Hesiod library to work properly.

       classes
	      Specifies which DNS classes Hesiod should do lookups in.	Possible values are IN (the preferred class) and HS (the deprecated class,
	      still  used by some sites).  You may specify both classes separated by a comma to try one class first and then the other if no entry
	      is available in the first class.	The default value of the classes variable is ``IN,HS''.

SEE ALSO

       hesiod(3)

BUGS

       There default value for ``lhs'' should probably be more reasonable.

								 30 November 1996						    HESIOD.CONF(5)

HESIOD(3)						     Library Functions Manual							 HESIOD(3)

NAME

       hesiod_getservbyname, hesiod_free_servent - Hesiod functions for retrieving service information

SYNOPSIS

       #include <hesiod.h>

       struct servent *hesiod_getservbyname(void *context,
	    const char *name, const char *proto)
       void hesiod_free_servent(void *context, struct servent *serv)

       cc file.c -lhesiod

DESCRIPTION

       This  family of functions allows you to retrieve service to port mappings using Hesiod.	To perform lookups, you need an initialized Hesiod
       context; see hesiod(3) for details.  Information is returned in the same format as by getservbyname.  It is the caller's responsibility	to
       call hesiod_free_servent with the returned service entry to free the resources used by the service entry.

       Hesiod  queries	for service information are made using the ``service'' Hesiod type, using the service name as the Hesiod name.	The corre-
       sponding records should be space-separated lists of strings giving the service name, protocol, port number (in decimal), and zero  or  more
       aliases	for  the  service.   There  may  be multiple records per service name; hesiod_getservbyname will pick the first one whose protocol
       matches proto.

RETURN VALUES

       On failure, hesiod_getservbyname returns NULL and sets the global variable errno to indicate the error.

ERRORS

       hesiod_getservbyname may fail for any of the reasons the routine hesiod_resolve may fail.

SEE ALSO

       hesiod(3)

								 30 November 1996							 HESIOD(3)