diff options
author | Steinar H. Gunderson <sesse@google.com> | 2007-11-15 08:36:25 +0000 |
---|---|---|
committer | Steinar H. Gunderson <sesse@google.com> | 2007-11-15 08:36:25 +0000 |
commit | b4bdb6d4d7915bf5e1a89b6ae19f7ffbcd2e8144 (patch) | |
tree | d1d94cb51374092ffc7f74e21eb342da707d7735 /ares_parse_a_reply.3 | |
parent | 7cd35ce69858bb06a446ef7620ea52807d67d306 (diff) | |
download | c-ares-b4bdb6d4d7915bf5e1a89b6ae19f7ffbcd2e8144.tar.gz c-ares-b4bdb6d4d7915bf5e1a89b6ae19f7ffbcd2e8144.tar.bz2 c-ares-b4bdb6d4d7915bf5e1a89b6ae19f7ffbcd2e8144.zip |
Return TTL data from ares_parse_{a,aaaa}_reply, if the user is so inclined. Patch from the Google tree.
Diffstat (limited to 'ares_parse_a_reply.3')
-rw-r--r-- | ares_parse_a_reply.3 | 21 |
1 files changed, 18 insertions, 3 deletions
diff --git a/ares_parse_a_reply.3 b/ares_parse_a_reply.3 index 7acd70f..fff8e23 100644 --- a/ares_parse_a_reply.3 +++ b/ares_parse_a_reply.3 @@ -22,24 +22,39 @@ ares_parse_a_reply \- Parse a reply to a DNS query of type A into a hostent .B #include <ares.h> .PP .B int ares_parse_a_reply(const unsigned char *\fIabuf\fP, int \fIalen\fP, -.B struct hostent **\fIhost\fP); +.B struct hostent **\fIhost\fP, +.B struct addrttl *\fIaddrttls\fB, int *\fInaddrttls\fB); .fi .SH DESCRIPTION The .B ares_parse_a_reply function parses the response to a query of type A into a -.BR "struct hostent" . +.BR "struct hostent" +and/or an array of +.BR "struct addrttls" . The parameters .I abuf and .I alen give the contents of the response. The result is stored in allocated memory and a pointer to it stored into the variable pointed to by -.IR host . +.IR host , +if host is nonnull. It is the caller's responsibility to free the resulting host structure using .BR ares_free_hostent (3) when it is no longer needed. +.PP +If +.IR addrttls +and +.IR naddrttls +are both nonnull, +then up to *naddrttls +.BR "struct addrttl" +records are stored in the array pointed to by addrttls, +and then *naddrttls is set to the number of records so stored. +Note that the memory for these records is supplied by the caller. .SH RETURN VALUES .B ares_parse_a_reply can return any of the following values: |