Makes a query and awaits a response.
Standard C Library (libc.a)
#include <sys/types.h>
#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>
int res_search (DomName, Class, Type, Answer, AnswerLength)
char * DomName;
int Class;
int Type;
u_char * Answer;
int AnswerLength;
The res_search subroutine makes a query and awaits a response like the res_query subroutine. However, it also implements the default and search rules controlled by the RES_DEFNAMES and RES_DNSRCH options.
The res_search subroutine is one of a set of subroutines that form the resolver, a set of functions that resolve domain names. The _res data structure contains global information used by the resolver subroutines. The /usr/include/resolv.h file contains the _res structure definition.
All applications containing the res_search subroutine must be compiled with the _BSD macro set to a specific value. Acceptable values are 43 and 44. In addition, all socket applications must include the BSD libbsd.a library.
Item | Description |
---|---|
DomName | Points to the name of the domain. If the DomName parameter
points to a single-component name and the RES_DEFNAMES structure
is set, as it is by default, the subroutine appends the default domain
name to the single-component name. The current domain name is defined
by the name server in use or is specified in the /etc/resolv.conf file. If the RES_DNSRCH bit is set, as it is by default, the res_search subroutine searches for host names in both the current domain and in parent domains. |
Class | Specifies one of the following values:
|
Type | Requires one of the following values:
|
Answer | Points to an address where the response is stored. |
AnswerLength | Specifies the size of the answer buffer. |
Upon successful completion, the res_search subroutine returns the size of the response. Upon unsuccessful completion, the res_search subroutine returns a value of -1 and sets the h_errno value to the appropriate error.
Item | Description |
---|---|
/etc/resolv.conf | Contains the name server and domain name. |