osf1 man page for dn_find

dn_find(3)						     Library Functions Manual							dn_find(3)

NAME
       dn_find - Searches for an expanded domain name

LIBRARY
       Standard C Library (libc.a)

SYNOPSIS
       #include <sys/types.h>

       #include <netinet/in.h>

       #include <arpa/nameser.h>

       #include <resolv.h>

       dn_find() (
	   char *exp_domain_name,
	   char *message,
	   char **domain_names,
	   char **end_ptr );

PARAMETERS
       Points to an expanded domain name.  Points to the address of a domain name message that contains the name sought by the dn_find() function.
       Specifies an array of pointers to previously compressed names in the current message.  Points to the end of  an	array  of  pointers.   The
       array is indicated by the domain_names parameter.

DESCRIPTION
       The  dn_find() (domain name find) function searches for an expanded domain name from a list of previously compressed names.  An application
       program calls the dn_find() function indirectly using the dn_comp() function.  If an expanded domain name is found, the dn_comp()  function
       returns the offset from the message parameter.

       The dn_find() function is one of a set of subroutines that form the resolver, a set of functions that resolves domain names.  Global infor-
       mation used by the resolver functions resides in the _res data structure.  The  include/resolv.h file contains the _res data structure def-
       inition.

RETURN VALUES
       Upon successful completion, the dn_find() function returns the offset from the message parameter. Otherwise, the dn_find() function returns
       a value of -1.

FILES
       Defines name server and domain name structures and constants.

RELATED INFORMATION
       Functions: res_init(3), res_mkquery(3), res_send(3), dn_comp(3), dn_expand(3), _getshort(3), _getlong(3), putshort(3), putlong(3), dn_skip-
       name(3)

       Commands: named(8) delim off

																	dn_find(3)