author | Milan Jurik <Milan.Jurik@oracle.com> |
Wed, 30 Nov 2011 06:39:13 -0800 | |
changeset 604 | c25824a87b1f |
permissions | -rw-r--r-- |
604
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
1 |
--- libevent-1.4.14b-stable/evdns.3 st lis 25 07:55:34 2009 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
2 |
+++ libevent-1.4.14b-stable/evdns.3 po lis 21 09:31:22 2011 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
3 |
@@ -25,66 +25,67 @@ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
4 |
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
5 |
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
6 |
.\" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
7 |
-.Dd October 7, 2006 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
8 |
-.Dt EVDNS 3 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
9 |
-.Os |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
10 |
-.Sh NAME |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
11 |
-.Nm evdns_init |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
12 |
-.Nm evdns_shutdown |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
13 |
-.Nm evdns_err_to_string |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
14 |
-.Nm evdns_nameserver_add |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
15 |
-.Nm evdns_count_nameservers |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
16 |
-.Nm evdns_clear_nameservers_and_suspend |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
17 |
-.Nm evdns_resume |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
18 |
-.Nm evdns_nameserver_ip_add |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
19 |
-.Nm evdns_resolve_ipv4 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
20 |
-.Nm evdns_resolve_reverse |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
21 |
-.Nm evdns_resolv_conf_parse |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
22 |
-.Nm evdns_config_windows_nameservers |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
23 |
-.Nm evdns_search_clear |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
24 |
-.Nm evdns_search_add |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
25 |
-.Nm evdns_search_ndots_set |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
26 |
-.Nm evdns_set_log_fn |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
27 |
-.Nd asynchronous functions for DNS resolution. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
28 |
-.Sh SYNOPSIS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
29 |
-.Fd #include <sys/time.h> |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
30 |
-.Fd #include <event.h> |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
31 |
-.Fd #include <evdns.h> |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
32 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
33 |
-.Fn evdns_init |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
34 |
-.Ft void |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
35 |
-.Fn evdns_shutdown "int fail_requests" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
36 |
-.Ft "const char *" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
37 |
-.Fn evdns_err_to_string "int err" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
38 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
39 |
-.Fn evdns_nameserver_add "unsigned long int address" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
40 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
41 |
-.Fn evdns_count_nameservers |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
42 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
43 |
-.Fn evdns_clear_nameservers_and_suspend |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
44 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
45 |
-.Fn evdns_resume |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
46 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
47 |
-.Fn evdns_nameserver_ip_add(const char *ip_as_string); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
48 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
49 |
-.Fn evdns_resolve_ipv4 "const char *name" "int flags" "evdns_callback_type callback" "void *ptr" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
50 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
51 |
-.Fn evdns_resolve_reverse "struct in_addr *in" "int flags" "evdns_callback_type callback" "void *ptr" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
52 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
53 |
-.Fn evdns_resolv_conf_parse "int flags" "const char *" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
54 |
-.Ft void |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
55 |
-.Fn evdns_search_clear |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
56 |
-.Ft void |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
57 |
-.Fn evdns_search_add "const char *domain" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
58 |
-.Ft void |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
59 |
-.Fn evdns_search_ndots_set "const int ndots" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
60 |
-.Ft void |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
61 |
-.Fn evdns_set_log_fn "evdns_debug_log_fn_type fn" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
62 |
-.Ft int |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
63 |
-.Fn evdns_config_windows_nameservers |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
64 |
-.Sh DESCRIPTION |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
65 |
+.TH EVDNS 3 "21 November 2011" "libevent 1.4.14b" "libevent Manual" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
66 |
+.SH NAME |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
67 |
+evdns_init, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
68 |
+evdns_shutdown, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
69 |
+evdns_err_to_string, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
70 |
+evdns_nameserver_add, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
71 |
+evdns_count_nameservers, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
72 |
+evdns_clear_nameservers_and_suspend, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
73 |
+evdns_resume, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
74 |
+evdns_nameserver_ip_add, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
75 |
+evdns_resolve_ipv4, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
76 |
+evdns_resolve_reverse, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
77 |
+evdns_resolv_conf_parse, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
78 |
+evdns_config_windows_nameservers, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
79 |
+evdns_search_clear, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
80 |
+evdns_search_add, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
81 |
+evdns_search_ndots_set, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
82 |
+evdns_set_log_fn |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
83 |
+\- asynchronous functions for DNS resolution. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
84 |
+.SH SYNOPSIS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
85 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
86 |
+.nf |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
87 |
+\fB#include <sys/time.h>\fP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
88 |
+\fB#include <event.h>\fP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
89 |
+\fB#include <evdns.h>\fP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
90 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
91 |
+\fBinit \fBevdns_init\fR\fR(\fBvoid\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
92 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
93 |
+\fBvoid \fBevdns_shutdown\fR\fR(\fBint \fIfail_requests\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
94 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
95 |
+\fBconst char* \fBevdns_err_to_string\fR\fR(\fBint \fIerr\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
96 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
97 |
+\fBint \fBevdns_nameserver_add\fR\fR(\fBunsigned long int \fIaddress\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
98 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
99 |
+\fBint \fBevdns_count_nameservers\fR\fR(\fBvoid\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
100 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
101 |
+\fBint \fBevdns_clear_nameservers_and_suspend\fR\fR(\fBvoid\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
102 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
103 |
+\fBint \fBevdns_resume\fR\fR(\fBvoid\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
104 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
105 |
+\fBint \fBevdns_nameserver_ip_add\fR\fR(\fBconst char* \fIip_as_string\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
106 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
107 |
+\fBint \fBevdns_resolve_ipv4\fR\fR(\fBconst char* \fIname\fP\fR, \fBint \fIflags\fP\fR, \fBevdns_callback_type \fIcallback\fP\fR, \fBvoid* \fIptr\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
108 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
109 |
+\fBint \fBevdns_resolve_reverse\fR\fR(\fBstruct in_addr* \fIin\fP\fR, \fBint \fIflags\fP\fR, \fBevdns_callback_type \fIcallback\fP\fR, \fBvoid* \fIptr\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
110 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
111 |
+\fBint \fBevdns_resolv_conf_parse\fR\fR(\fBint \fIflags\fP\fR, \fBconst char* \fIfilename\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
112 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
113 |
+\fBvoid \fBevdns_search_clear\fR\fR(\fBvoid\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
114 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
115 |
+\fBvoid \fBevdns_search_add\fR\fR(\fBconst char* \fIdomain\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
116 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
117 |
+\fBvoid \fBevdns_search_ndots_set\fR\fR(\fBconst int \fIndots\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
118 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
119 |
+\fBvoid \fBevdns_set_log_fn\fR\fR(\fBcevdns_debug_log_fn_type \fIfn\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
120 |
+ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
121 |
+\fBint \fBevdns_config_windows_nameservers\fR\fR(\fBvoid\fP\fR); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
122 |
+.fi |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
123 |
+.SH DESCRIPTION |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
124 |
Welcome, gentle reader |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
125 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
126 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
127 |
Async DNS lookups are really a whole lot harder than they should be, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
128 |
mostly stemming from the fact that the libc resolver has never been |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
129 |
very good at them. Before you use this library you should see if libc |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
130 |
@@ -91,37 +92,49 @@ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
131 |
can do the job for you with the modern async call getaddrinfo_a |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
132 |
(see http://www.imperialviolet.org/page25.html#e498). Otherwise, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
133 |
please continue. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
134 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
135 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
136 |
This code is based on libevent and you must call event_init before |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
137 |
any of the APIs in this file. You must also seed the OpenSSL random |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
138 |
source if you are using OpenSSL for ids (see below). |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
139 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
140 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
141 |
This library is designed to be included and shipped with your source |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
142 |
code. You statically link with it. You should also test for the |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
143 |
existence of strtok_r and define HAVE_STRTOK_R if you have it. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
144 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
145 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
146 |
The DNS protocol requires a good source of id numbers and these |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
147 |
numbers should be unpredictable for spoofing reasons. There are |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
148 |
three methods for generating them here and you must define exactly |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
149 |
one of them. In increasing order of preference: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
150 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
151 |
-.Bl -tag -width "DNS_USE_GETTIMEOFDAY_FOR_ID" -compact -offset indent |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
152 |
-.It DNS_USE_GETTIMEOFDAY_FOR_ID |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
153 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
154 |
+DNS_USE_GETTIMEOFDAY_FOR_ID |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
155 |
+.ad |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
156 |
+.sp .6 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
157 |
+.RS 4n |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
158 |
Using the bottom 16 bits of the usec result from gettimeofday. This |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
159 |
is a pretty poor solution but should work anywhere. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
160 |
-.It DNS_USE_CPU_CLOCK_FOR_ID |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
161 |
+.RE |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
162 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
163 |
+DNS_USE_CPU_CLOCK_FOR_ID |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
164 |
+.ad |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
165 |
+.sp .6 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
166 |
+.RS 4n |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
167 |
Using the bottom 16 bits of the nsec result from the CPU's time |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
168 |
counter. This is better, but may not work everywhere. Requires |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
169 |
POSIX realtime support and you'll need to link against -lrt on |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
170 |
glibc systems at least. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
171 |
-.It DNS_USE_OPENSSL_FOR_ID |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
172 |
+.RE |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
173 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
174 |
+DNS_USE_OPENSSL_FOR_ID |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
175 |
+.ad |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
176 |
+.sp .6 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
177 |
+.RS 4n |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
178 |
Uses the OpenSSL RAND_bytes call to generate the data. You must |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
179 |
have seeded the pool before making any calls to this library. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
180 |
-.El |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
181 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
182 |
+.RE |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
183 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
184 |
The library keeps track of the state of nameservers and will avoid |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
185 |
them when they go down. Otherwise it will round robin between them. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
186 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
187 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
188 |
Quick start guide: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
189 |
#include "evdns.h" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
190 |
void callback(int result, char type, int count, int ttl, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
191 |
@@ -128,7 +141,7 @@ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
192 |
void *addresses, void *arg); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
193 |
evdns_resolv_conf_parse(DNS_OPTIONS_ALL, "/etc/resolv.conf"); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
194 |
evdns_resolve("www.hostname.com", 0, callback, NULL); |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
195 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
196 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
197 |
When the lookup is complete the callback function is called. The |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
198 |
first argument will be one of the DNS_ERR_* defines in evdns.h. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
199 |
Hopefully it will be DNS_ERR_NONE, in which case type will be |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
200 |
@@ -136,152 +149,187 @@ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
201 |
which the data can be cached for (in seconds), addresses will point |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
202 |
to an array of uint32_t's and arg will be whatever you passed to |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
203 |
evdns_resolve. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
204 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
205 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
206 |
Searching: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
207 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
208 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
209 |
In order for this library to be a good replacement for glibc's resolver it |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
210 |
supports searching. This involves setting a list of default domains, in |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
211 |
which names will be queried for. The number of dots in the query name |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
212 |
determines the order in which this list is used. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
213 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
214 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
215 |
Searching appears to be a single lookup from the point of view of the API, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
216 |
although many DNS queries may be generated from a single call to |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
217 |
evdns_resolve. Searching can also drastically slow down the resolution |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
218 |
of names. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
219 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
220 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
221 |
To disable searching: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
222 |
-.Bl -enum -compact -offset indent |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
223 |
-.It |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
224 |
-Never set it up. If you never call |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
225 |
-.Fn evdns_resolv_conf_parse, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
226 |
-.Fn evdns_init, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
227 |
+.ad |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
228 |
+.sp .6 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
229 |
+.RS 4n |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
230 |
+1. Never set it up. If you never call |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
231 |
+\fBevdns_resolv_conf_parse\fP\fR, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
232 |
+\fBevdns_init\fP\fR, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
233 |
or |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
234 |
-.Fn evdns_search_add |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
235 |
+\fBevdns_search_add\fP\R |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
236 |
then no searching will occur. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
237 |
-.It |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
238 |
-If you do call |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
239 |
-.Fn evdns_resolv_conf_parse |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
240 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
241 |
+2. If you do call |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
242 |
+\fBevdns_resolv_conf_parse\fP\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
243 |
then don't pass |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
244 |
-.Va DNS_OPTION_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
245 |
+DNS_OPTION_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
246 |
(or |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
247 |
-.Va DNS_OPTIONS_ALL, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
248 |
+DNS_OPTIONS_ALL, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
249 |
which implies it). |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
250 |
-.It |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
251 |
-When calling |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
252 |
-.Fn evdns_resolve, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
253 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
254 |
+3. When calling |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
255 |
+\fBevdns_resolve\fP\fR, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
256 |
pass the |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
257 |
-.Va DNS_QUERY_NO_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
258 |
+DNS_QUERY_NO_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
259 |
flag. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
260 |
-.El |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
261 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
262 |
+.RE |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
263 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
264 |
The order of searches depends on the number of dots in the name. If the |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
265 |
number is greater than the ndots setting then the names is first tried |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
266 |
globally. Otherwise each search domain is appended in turn. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
267 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
268 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
269 |
The ndots setting can either be set from a resolv.conf, or by calling |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
270 |
evdns_search_ndots_set. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
271 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
272 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
273 |
For example, with ndots set to 1 (the default) and a search domain list of |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
274 |
["myhome.net"]: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
275 |
Query: www |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
276 |
Order: www.myhome.net, www. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
277 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
278 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
279 |
Query: www.abc |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
280 |
Order: www.abc., www.abc.myhome.net |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
281 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
282 |
-.Sh API reference |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
283 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
284 |
-.Bl -tag -width 0123456 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
285 |
-.It Ft int Fn evdns_init |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
286 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
287 |
+.SH API reference |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
288 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
289 |
+.SS "\fBint \fBevdns_init\fR\fR(\fBvoid\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
290 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
291 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
292 |
Initializes support for non-blocking name resolution by calling |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
293 |
-.Fn evdns_resolv_conf_parse |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
294 |
+evdns_resolv_conf_parse() |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
295 |
on UNIX and |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
296 |
-.Fn evdns_config_windows_nameservers |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
297 |
+evdns_config_windows_nameservers() |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
298 |
on Windows. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
299 |
-.It Ft int Fn evdns_nameserver_add "unsigned long int address" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
300 |
+.SS "\fBint \fBevdns_nameserver_add\fR\fR(\fBunsigned long int\fP\fR \fIaddress\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
301 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
302 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
303 |
Add a nameserver. The address should be an IP address in |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
304 |
network byte order. The type of address is chosen so that |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
305 |
it matches in_addr.s_addr. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
306 |
Returns non-zero on error. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
307 |
-.It Ft int Fn evdns_nameserver_ip_add "const char *ip_as_string" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
308 |
+.SS "\fBint \fBevdns_nameserver_ip_add\fR\fR(\fBconst char* \fIip_as_string\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
309 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
310 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
311 |
This wraps the above function by parsing a string as an IP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
312 |
address and adds it as a nameserver. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
313 |
Returns non-zero on error |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
314 |
-.It Ft int Fn evdns_resolve "const char *name" "int flags" "evdns_callback_type callback" "void *ptr" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
315 |
+.SS "\fBint \fBevdns_resolve\fR\fR(\fBconst char* \fIname\fP\fR, \fBint \fIflags\fP\fR, \fBevdns_callback_type \fIcallback\fP\fR, \fBvoid* \fIptr\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
316 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
317 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
318 |
Resolve a name. The name parameter should be a DNS name. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
319 |
The flags parameter should be 0, or DNS_QUERY_NO_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
320 |
which disables searching for this query. (see defn of |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
321 |
searching above). |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
322 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
323 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
324 |
The callback argument is a function which is called when |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
325 |
this query completes and ptr is an argument which is passed |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
326 |
to that callback function. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
327 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
328 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
329 |
Returns non-zero on error |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
330 |
-.It Ft void Fn evdns_search_clear |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
331 |
+.SS "\fBvoid \fBevdns_search_clear\fR\fR(\fBvoid\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
332 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
333 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
334 |
Clears the list of search domains |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
335 |
-.It Ft void Fn evdns_search_add "const char *domain" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
336 |
+.SS "\fBvoid \fBevdns_search_add\fR\fR(\fBconst char* \fIdomain\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
337 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
338 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
339 |
Add a domain to the list of search domains |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
340 |
-.It Ft void Fn evdns_search_ndots_set "int ndots" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
341 |
+.SS "\fBvoid \fBevdns_search_ndots_set\fR\fR(\fBconst int \fIndots\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
342 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
343 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
344 |
Set the number of dots which, when found in a name, causes |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
345 |
the first query to be without any search domain. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
346 |
-.It Ft int Fn evdns_count_nameservers "void" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
347 |
+.SS "\fBint \fBevdns_count_nameservers\fR\fR(\fBvoid\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
348 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
349 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
350 |
Return the number of configured nameservers (not necessarily the |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
351 |
number of running nameservers). This is useful for double-checking |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
352 |
whether our calls to the various nameserver configuration functions |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
353 |
have been successful. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
354 |
-.It Ft int Fn evdns_clear_nameservers_and_suspend "void" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
355 |
+.SS "\fBint \fBevdns_clear_nameservers_and_suspend\fR\fR(\fBvoid\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
356 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
357 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
358 |
Remove all currently configured nameservers, and suspend all pending |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
359 |
resolves. Resolves will not necessarily be re-attempted until |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
360 |
evdns_resume() is called. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
361 |
-.It Ft int Fn evdns_resume "void" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
362 |
+.SS "\fBint \fBevdns_resume\fR\fR(\fBvoid\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
363 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
364 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
365 |
Re-attempt resolves left in limbo after an earlier call to |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
366 |
evdns_clear_nameservers_and_suspend(). |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
367 |
-.It Ft int Fn evdns_config_windows_nameservers "void" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
368 |
+.SS "\fBint \fBevdns_config_windows_nameservers\fR\fR(\fBvoid\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
369 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
370 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
371 |
Attempt to configure a set of nameservers based on platform settings on |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
372 |
a win32 host. Preferentially tries to use GetNetworkParams; if that fails, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
373 |
looks in the registry. Returns 0 on success, nonzero on failure. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
374 |
-.It Ft int Fn evdns_resolv_conf_parse "int flags" "const char *filename" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
375 |
+.SS "\fBint \fBevdns_resolv_conf_parse\fR\fR(\fBint \fIflags\fP\fR, \fBconst char*filename\fP\fR)" |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
376 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
377 |
+.LP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
378 |
Parse a resolv.conf like file from the given filename. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
379 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
380 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
381 |
See the man page for resolv.conf for the format of this file. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
382 |
The flags argument determines what information is parsed from |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
383 |
this file: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
384 |
-.Bl -tag -width "DNS_OPTION_NAMESERVERS" -offset indent -compact -nested |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
385 |
-.It DNS_OPTION_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
386 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
387 |
+DNS_OPTION_SEARCH |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
388 |
domain, search and ndots options |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
389 |
-.It DNS_OPTION_NAMESERVERS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
390 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
391 |
+DNS_OPTION_NAMESERVERS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
392 |
nameserver lines |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
393 |
-.It DNS_OPTION_MISC |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
394 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
395 |
+DNS_OPTION_MISC |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
396 |
timeout and attempts options |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
397 |
-.It DNS_OPTIONS_ALL |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
398 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
399 |
+DNS_OPTIONS_ALL |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
400 |
all of the above |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
401 |
-.El |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
402 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
403 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
404 |
The following directives are not parsed from the file: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
405 |
sortlist, rotate, no-check-names, inet6, debug |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
406 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
407 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
408 |
Returns non-zero on error: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
409 |
-.Bl -tag -width "0" -offset indent -compact -nested |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
410 |
-.It 0 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
411 |
+.sp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
412 |
+0 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
413 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
414 |
no errors |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
415 |
-.It 1 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
416 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
417 |
+1 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
418 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
419 |
failed to open file |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
420 |
-.It 2 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
421 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
422 |
+2 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
423 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
424 |
failed to stat file |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
425 |
-.It 3 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
426 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
427 |
+3 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
428 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
429 |
file too large |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
430 |
-.It 4 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
431 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
432 |
+4 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
433 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
434 |
out of memory |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
435 |
-.It 5 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
436 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
437 |
+5 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
438 |
+.br |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
439 |
short read from file |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
440 |
-.El |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
441 |
-.El |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
442 |
-.Sh Internals: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
443 |
+.SH Internals: |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
444 |
Requests are kept in two queues. The first is the inflight queue. In |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
445 |
this queue requests have an allocated transaction id and nameserver. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
446 |
They will soon be transmitted if they haven't already been. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
447 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
448 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
449 |
The second is the waiting queue. The size of the inflight ring is |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
450 |
limited and all other requests wait in waiting queue for space. This |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
451 |
bounds the number of concurrent requests so that we don't flood the |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
452 |
@@ -288,33 +336,33 @@ |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
453 |
nameserver. Several algorithms require a full walk of the inflight |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
454 |
queue and so bounding its size keeps thing going nicely under huge |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
455 |
(many thousands of requests) loads. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
456 |
-.Pp |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
457 |
+.PP |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
458 |
If a nameserver loses too many requests it is considered down and we |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
459 |
try not to use it. After a while we send a probe to that nameserver |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
460 |
(a lookup for google.com) and, if it replies, we consider it working |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
461 |
again. If the nameserver fails a probe we wait longer to try again |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
462 |
with the next probe. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
463 |
-.Sh SEE ALSO |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
464 |
-.Xr event 3 , |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
465 |
-.Xr gethostbyname 3 , |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
466 |
-.Xr resolv.conf 5 |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
467 |
-.Sh HISTORY |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
468 |
+.SH SEE ALSO |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
469 |
+\fBevent(3)\fR, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
470 |
+\fBgethostbyname(3)\fR, |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
471 |
+\fBresolv.conf(4)\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
472 |
+.SH HISTORY |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
473 |
The |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
474 |
-.Nm evdns |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
475 |
+\fIevdns\fP\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
476 |
API was developed by Adam Langley on top of the |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
477 |
-.Nm libevent |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
478 |
+\fIlibevent\fP\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
479 |
API. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
480 |
The code was integrate into |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
481 |
-.Nm Tor |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
482 |
+\fITor\fP\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
483 |
by Nick Mathewson and finally put into |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
484 |
-.Nm libevent |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
485 |
+\fIlibevent\fP\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
486 |
itself by Niels Provos. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
487 |
-.Sh AUTHORS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
488 |
+.SH AUTHORS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
489 |
The |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
490 |
-.Nm evdns |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
491 |
+\fIevdns\fP\fR |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
492 |
API and code was written by Adam Langley with significant |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
493 |
contributions by Nick Mathewson. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
494 |
-.Sh BUGS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
495 |
+.SH BUGS |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
496 |
This documentation is neither complete nor authoritative. |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
497 |
If you are in doubt about the usage of this API then |
c25824a87b1f
6674902 a lot of superfluous calls to clock_gettime if timed events is not used
Milan Jurik <Milan.Jurik@oracle.com>
parents:
diff
changeset
|
498 |
check the source code to find out how it works, write |