path: root/ares_search.3
diff options
authorSteinar H. Gunderson <>2007-09-28 14:46:51 (GMT)
committerSteinar H. Gunderson <>2007-09-28 14:46:51 (GMT)
commit50ba81cd230f9054fa7c45cb4202ce8720c502b3 (patch)
tree277c02b995aacc09540ec58270e10cd1845ff2b3 /ares_search.3
parentb669e17544c0ff64d120b8a0df2677c59ccea8fd (diff)
Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.)
Diffstat (limited to 'ares_search.3')
1 files changed, 6 insertions, 1 deletions
diff --git a/ares_search.3 b/ares_search.3
index 2e93ba3..f5bf80d 100644
--- a/ares_search.3
+++ b/ares_search.3
@@ -22,7 +22,7 @@ ares_search \- Initiate a DNS query with domain search
.B #include <ares.h>
.B typedef void (*ares_callback)(void *\fIarg\fP, int \fIstatus\fP,
-.B unsigned char *\fIabuf\fP, int \fIalen\fP)
+.B int \fItimeouts\fP, unsigned char *\fIabuf\fP, int \fIalen\fP)
.B void ares_search(ares_channel \fIchannel\fP, const char *\fIname\fP,
.B int \fIdnsclass\fP, int \fItype\fP, ares_callback \fIcallback\fP,
@@ -125,6 +125,11 @@ The name service channel
.I channel
is being destroyed; the query will not be completed.
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
If a query completed successfully, the callback argument
.I abuf
points to a result buffer of length