Changeset 5513 for pjproject/branches/projects/uwp/pjlib-util/include/pjlib-util/resolver.h

Timestamp:

Dec 28, 2016 3:40:07 AM (8 years ago)

Author:

nanang

Message:

Re #1900: More merged from trunk (r5512 mistakenly contains merged changes in third-party dir only).

Location:

pjproject/branches/projects/uwp

Files:

• . (modified) (1 prop)
• pjlib-util/include/pjlib-util/resolver.h (modified) (2 diffs)

pjproject/branches/projects/uwp/pjlib-util/include/pjlib-util/resolver.h

@@ -224 +224 @@
 
 } pj_dns_a_record;
+
+
+/**
+ * This structure represents DNS address record, i.e: DNS A and DNS AAAA
+ * records, as the result of parsing DNS response packet using
+ * #pj_dns_parse_addr_response().
+ */
+typedef struct pj_dns_addr_record
+{
+    /** The target name being queried.   */
+    pj_str_t            name;
+
+    /** If target name corresponds to a CNAME entry, the alias contains
+     *  the value of the CNAME entry, otherwise it will be empty.
+     */
+    pj_str_t            alias;
+
+    /** Number of IP addresses. */
+    unsigned            addr_count;
+
+    /** IP addresses of the host found in the response */
+    struct {
+
+        /** IP address family */
+        int             af;
+        
+        /** IP address */
+        union {
+            /** IPv4 address */
+            pj_in_addr  v4;
+
+            /** IPv6 address */
+            pj_in6_addr v6;
+        } ip;
+
+    } addr[PJ_DNS_MAX_IP_IN_A_REC];
+
+    /** Internal buffer for hostname and alias. */
+    char                buf_[128];
+
+} pj_dns_addr_record;
 
 
@@ -409 +450 @@
 
 /**
+ * A utility function to parse a DNS response containing AAAA records into 
+ * DNS AAAA record.
+ *
+ * @param pkt       The DNS response packet.
+ * @param rec       The structure to be initialized with the parsed
+ *                  DNS AAAA record from the packet.
+ *
+ * @return          PJ_SUCCESS if response can be parsed successfully.
+ */
+PJ_DECL(pj_status_t) pj_dns_parse_addr_response(
+                                            const pj_dns_parsed_packet *pkt,
+                                            pj_dns_addr_record *rec);
+
+
+/**
  * Put the specified DNS packet into DNS cache. This function is mainly used
  * for testing the resolver, however it can also be used to inject entries