res_query(3) [osf1 man page]

res_search(3)						     Library Functions Manual						     res_search(3)

NAME

       res_search, res_query - Queries domain server and checks response

LIBRARY

       Standard C Library (libc.a, libc.so)

SYNOPSIS

       #include <sys/types.h> #include <netinet/in.h> #include <arpa/nameser.h> #include <resolv.h>
       int res_search (      const char *domain_name,	   int class,	   int type,	  u_char *answer,      int answer_len;)

       The  res_query  syntax  is  as  follows:  int res_query (      const char *domain_name,	    int class,	    int type,	   u_char *answer,
	    int answer_len;)

PARAMETERS

       Points to the fully-qualified name of the domain.  If the domain_name parameter points to a single label and the RES_DEFNAMES bit  is  set,
       as it is by default, the function appends domain_name to the current domain name.  The current domain name is defined by the name server in
       use or in the /etc/resolv.conf file.  Specifies one of the following parameters: Specifies the ARPA Internet.  Specifies the Chaos  network
       at  MIT.   Requires  one of the following values: Host address Authoritative server Mail destination Mail forwarder Canonical name Start of
       authority zone Mailbox domain name Mail group member Mail rename name NULL resource record Well known  service  Domain  name  pointer  Host
       information  Mailbox  information  Mail routing information User (finger) information User ID Group ID Points to a location of the server's
       reply.  Specifies the length of the answer pointed to by the answer parameter.

DESCRIPTION

       The res_search() and res_query() functions construct a query, send it to the local server, and await a response.  In addition, res_search()
       implements the default and search rules specified by the RES_DEFNAMES and RES_DNSRCH resolver options.  The function returns the first suc-
       cessful reply.

       The res_search() and res_query() functions part of a set of subroutines that form the resolver, a set  of  functions  that  resolve  domain
       names.  Global information that is used by the resolver functions is kept in the _res data structure.  The  /include/resolv.h file contains
       the _res data structure definition.

RETURN VALUES

       Upon successful completion, the res_search() function returns the size of the answer. If the  answer  is  larger  than  the  value  of  the
       answer_len parameter, the function fails and returns a value of -1.

ERRORS

       If  an  error  occurs  during  a  resolver  operation,  the h_errno external variable is set.  Error code values and reasons are defined in
       <netdb.h>.

FILES

       Contains the name server and domain name.

RELATED INFORMATION

       Functions:  dn_comp(3),	dn_expand(3),  dn_find(3),  dn_skipname(3),  _getlong(3),  _getshort(3),  putlong(3),  putshort(3),   res_init(3),
       res_mkquery(3), res_query(3), res_send(3).  delim off

																     res_search(3)

Check Out this Related Man Page

dn_expand(3)						     Library Functions Manual						      dn_expand(3)

NAME

       dn_expand - Expands a compressed domain name

LIBRARY

       Standard C Library (libc.a, libc.so)

SYNOPSIS

       #include <sys/types.h> #include <netinet/in.h> #include <arpa/nameser.h> #include <resolv.h>

       int dn_expand (
	   const u_char *message_ptr,
	   const u_char *end_of_message,
	   const u_char *compressed_name,
	   char *expanded_name,
	   int length );

PARAMETERS

       Specifies  a  pointer  to  the beginning of a message.  Points to the end of the original message that contains the compressed domain name.
       Specifies a pointer to a compressed domain name.  Specifies a pointer to a buffer that holds the resulting expanded domain name.  Specifies
       the size of the buffer pointed to by the expanded_name parameter.

DESCRIPTION

       The dn_expand() function expands a compressed domain name to a full domain name, converting the expanded names to uppercase.

       The  dn_expand()  function  is  one  of a set of subroutines that form the resolver, a set of functions that resolves domain names.  Global
       information that is used by the resolver functions is kept in the _res data structure.	The   /include/resolv.h  file  contains  the  _res
       structure definition.

RETURN VALUES

       Upon successful completion, the dn_expand() function returns the size of the compressed domain name.  Otherwise, a value of -1 is returned.

ERRORS

       If  an  error  occurs  during  a  resolver  operation,  the h_errno external variable is set.  Error code values and reasons are defined in
       <netdb.h>.

FILES

       Defines name server and domain name constants, structures, and values.

RELATED INFORMATION

       Functions: dn_comp(3), dn_find(3), dn_skipname(3),  putshort(3),  putlong(3),  res_init(3),  res_mkquery(3),  res_query(3),  res_search(3),
       res_send(3), _getshort(3), _getlong(3).	delim off

																      dn_expand(3)

Linux and UNIX Man Pages

res_query(3) [osf1 man page]

Check Out this Related Man Page