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.)

1 files changed, 6 insertions, 1 deletions

diff --git a/ares/ares_getnameinfo.3 b/ares/ares_getnameinfo.3
index 9b6bd73a9..55918ffba 100644
--- a/ares/ares_getnameinfo.3
+++ b/ares/ares_getnameinfo.3
@@ -22,7 +22,7 @@ ares_getnameinfo \- Address-to-nodename translation in protocol-independent mann
 .B #include <ares.h>

 .PP

 .B typedef void (*ares_nameinfo_callback)(void *\fIarg\fP, int \fIstatus\fP,

-.B	char *\fInode\fP, char *\fIservice\fP)

+.B	int \fItimeouts\fP, char *\fInode\fP, char *\fIservice\fP)

 .PP

 .B void ares_getnameinfo(ares_channel \fIchannel\fP, const struct sockaddr *\fIsa\fP,

 .B 	socklen_t \fIsalen\fP, int \fIflags\fP, ares_nameinfo_callback \fIcallback\fP,

@@ -120,6 +120,11 @@ The
 .I flags

 parameter contains an illegal value.

 .PP

+The callback argument

+.I timeouts

+reports how many times a query timed out during the execution of the

+given request.

+.PP

 On successful completion of the query, the callback argument

 .I node

 contains a string representing the hostname (assuming