DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

ares_parse_mx_reply(3)




ARES_PARSE_MX_REPLY(3) C LIBRARY FUNCTIONS ARES_PARSE_MX_REPLY(3)


NAME

     ares_parse_mx_reply - Parse a reply to a DNS query  of  type
     MX


SYNOPSIS

     #include <ares.h>

     int ares_parse_mx_reply(const unsigned char* abuf, int
     struct ares_mx_reply** mx_out);


DESCRIPTION

     The ares_parse_mx_reply function parses the  response  to  a
     query  of type MX into a linked list of struct ares_mx_reply
     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 mx_out.
     It  is  the  caller's  responsibility  to free the resulting
     mx_out structure when it is no longer needed using the func-
     tion ares_free_data

     The structure ares_mx_reply contains the following fields:

         struct ares_mx_reply {
             struct ares_mx_reply *next;
             char *host;
             unsigned short priority;
         };


RETURN VALUES

     ares_parse_mx_reply can return any of the following values:

     ARES_SUCCESS   The response was successfully parsed.

     ARES_EBADRESP  The response was malformatted.

     ARES_ENODATA   The response did not contain an answer to the
                    query.

     ARES_ENOMEM    Memory was exhausted.


AVAILABILITY

     This function was first introduced in c-ares version 1.7.2.


SEE ALSO

     ares_query(3) ares_free_data(3)


AUTHOR

     Written by Jeremy Lal <kapouer@melix.org>

                   Last change: 4 August 2009                   1


Man(1) output converted with man2html