1val_res_query(3)              Programmer's Manual             val_res_query(3)
2
3
4

NAME

6       val_res_query(), val_res_search() - DNSSEC-validated resolution of DNS
7       queries
8

SYNOPSIS

10         #include <validator/validator.h>
11
12         int val_res_query(const val_context_t *ctx,
13                           const char *dname,
14                           int class,
15                           int type,
16                           unsigned char *answer,
17                           int anslen,
18                           val_status_t *val_status);
19
20         int val_res_search(val_context_t * ctx,
21                   const char *dname,
22                   int class_h,
23                   int type,
24                   unsigned char * answer,
25                   int anslen,
26                   val_status_t * val_status);
27

DESCRIPTION

29       The val_res_query() function performs DNSSEC validation of DNS queries.
30       It is a DNSSEC-aware substitute for the res_query(3) legacy function.
31       val_res_search() performs an operation similar to val_res_query().  In
32       addition, it uses the search paths specified within the
33       /etc/resolv.conf file to create the fully qualified domain name.
34       val_res_search() is a DNSSEC-aware substitute for the res_search(3)
35       function.
36
37       The ctx parameter is the validator context and can be set to NULL for
38       default settings.  More information about this field can be found in
39       libval(3).
40
41       The dname parameter specifies the domain name, class specifies the DNS
42       class and type specifies the DNS type.
43
44       The validation status values for val_res_query() and val_res_search()
45       functions are returned in their respective val_status fields.
46       p_val_status() returns a brief string description of the error code.
47       val_istrusted() determines if the status code indicates that the
48       response can be trusted and val_isvalidated() determines if the status
49       code indicates that the response was validated.  (See libval(3) for
50       further information).
51

RETURN VALUES

53       val_res_query() and val_res_search() return the number of bytes
54       received on success and -1 on failure.
55

57       Copyright 2004-2013 SPARTA, Inc.  All rights reserved.  See the COPYING
58       file included with the DNSSEC-Tools package for details.
59

AUTHORS

61       Abhijit Hayatnagarkar, Suresh Krishnaswamy, Robert Story.
62

SEE ALSO

64       res_query(3)
65
66       get_context(3), val_getaddrinfo(3), val_gethostbyname(3)
67
68       libval(3)
69
70       http://www.dnssec-tools.org
71
72
73
74perl v5.12.4                      2013-03-08                  val_res_query(3)
Impressum