From: Azat Khuzhin <azat@libevent.org>
Date: Sun, 31 Mar 2019 22:40:18 +0000 (+0300)
Subject: evdns: add descriptions for DNS_OPTION_*/DNS_OPTIONS_ALL
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3e0dc1a6ab4b7024b93dc44c1bb79df0ef637fc0;p=libevent

evdns: add descriptions for DNS_OPTION_*/DNS_OPTIONS_ALL
---

diff --git a/include/event2/dns.h b/include/event2/dns.h
index 902544c2..358b30fd 100644
--- a/include/event2/dns.h
+++ b/include/event2/dns.h
@@ -179,11 +179,36 @@ extern "C" {
 
 #define DNS_QUERY_NO_SEARCH 1
 
+/* Allow searching */
 #define DNS_OPTION_SEARCH 1
+/* Parse "nameserver" and add default if no such section */
 #define DNS_OPTION_NAMESERVERS 2
+/* Parse additional options like:
+ * - timeout:
+ * - getaddrinfo-allow-skew:
+ * - max-timeouts:
+ * - max-inflight:
+ * - attempts:
+ * - randomize-case:
+ * - initial-probe-timeout:
+ */
 #define DNS_OPTION_MISC 4
+/* Load hosts file (i.e. "/etc/hosts") */
 #define DNS_OPTION_HOSTSFILE 8
-#define DNS_OPTIONS_ALL 15
+/**
+ * All above:
+ * - DNS_OPTION_SEARCH
+ * - DNS_OPTION_NAMESERVERS
+ * - DNS_OPTION_MISC
+ * - DNS_OPTION_HOSTSFILE
+ */
+#define DNS_OPTIONS_ALL (    \
+    DNS_OPTION_SEARCH      | \
+    DNS_OPTION_NAMESERVERS | \
+    DNS_OPTION_MISC        | \
+    DNS_OPTION_HOSTSFILE   | \
+    0                        \
+)
 
 /* Obsolete name for DNS_QUERY_NO_SEARCH */
 #define DNS_NO_SEARCH DNS_QUERY_NO_SEARCH