Copyright 1998 by the Massachusetts Institute of Technology.
Permission to use, copy, modify, and distribute this
software and its documentation for any purpose and without
fee is hereby granted, provided that the above copyright
notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting
documentation, and that the name of M.I.T. not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
M.I.T. makes no representations about the suitability of
this software for any purpose. It is provided "as is"
without express or implied warranty.
ARES_PARSE_A_REPLY 3 "25 July 1998"
NAME
ares_parse_a_reply - Parse a reply to a DNS query of type A
SYNOPSIS
#include <ares.h>int ares_parse_a_reply(const unsigned char *abuf, int alen, struct hostent **host, struct ares_addrttl *addrttls, int *naddrttls);
DESCRIPTION
The
ares_parse_a_reply function parses the response to a query of type A into a
"struct hostent" and/or an array of
"struct ares_addrttls" . The parameters
abuf and
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
host , if host is nonnull.
It is the caller's responsibility to free the resulting host structure
using
ares_free_hostent (3) when it is no longer needed.
If addrttls and naddrttls are both nonnull, then up to *naddrttls "struct ares_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.
RETURN VALUES
ares_parse_a_reply can return any of the following values:
15 ARES_SUCCESS The response was successfully parsed.
15 ARES_EBADRESP The response was malformatted.
15 ARES_ENODATA The response did not contain an answer to the query.
15 ARES_ENOMEM Memory was exhausted.
SEE ALSO
ares_gethostbyname (3), ares_free_hostent (3) AUTHOR
Greg Hudson, MIT Information Systems
Andrew Selivanov <andrew.selivanov@gmail.com>
Copyright 1998 by the Massachusetts Institute of Technology.