Updated README.

[adns] / src / adns.h

diff --git a/src/adns.h b/src/adns.h
index fa9b6ca560d9fde9eb86d6355503d5f8e7249c14..b8c5b0223d25407bebc9cc2f7375486084e15f90 100644 (file)
--- a/src/adns.h
+++ b/src/adns.h
@@ -336,10 +336,10 @@ typedef struct {
  *  requested.
  */
 
  *  requested.
  */
 

-int adns_init(adns_state *newstate_r, adns_initflags flags,
+int adns_init(adns_state *newstate_r, int flags /*adns_initflags*/,

              FILE *diagfile /*0=>stderr*/);
 
              FILE *diagfile /*0=>stderr*/);
 

-int adns_init_strcfg(adns_state *newstate_r, adns_initflags flags,
+int adns_init_strcfg(adns_state *newstate_r, int flags /*adns_initflags*/,

                     FILE *diagfile /*0=>discard*/, const char *configtext);
 
 /* Configuration:
                     FILE *diagfile /*0=>discard*/, const char *configtext);
 
 /* Configuration:


@@ -443,7 +443,7 @@ int adns_init_strcfg(adns_state *newstate_r, adns_initflags flags,
 int adns_synchronous(adns_state ads,
                     const char *owner,
                     adns_rrtype type,
 int adns_synchronous(adns_state ads,
                     const char *owner,
                     adns_rrtype type,

-                    adns_queryflags flags,
+                    int flags /*adns_queryflags*/,

                     adns_answer **answer_r);
 
 /* NB: if you set adns_if_noautosys then _submit and _check do not
                     adns_answer **answer_r);
 
 /* NB: if you set adns_if_noautosys then _submit and _check do not


@@ -454,7 +454,7 @@ int adns_synchronous(adns_state ads,
 int adns_submit(adns_state ads,
                const char *owner,
                adns_rrtype type,
 int adns_submit(adns_state ads,
                const char *owner,
                adns_rrtype type,

-               adns_queryflags flags,
+               int flags /*adns_queryflags*/,

                void *context,
                adns_query *query_r);
 
                void *context,
                adns_query *query_r);
 


@@ -493,10 +493,12 @@ void adns_cancel(adns_query query);
 int adns_submit_reverse(adns_state ads,
                        const struct sockaddr *addr,
                        adns_rrtype type,
 int adns_submit_reverse(adns_state ads,
                        const struct sockaddr *addr,
                        adns_rrtype type,

-                       adns_queryflags flags,
+                       int flags /*adns_queryflags*/,

                        void *context,
                        adns_query *query_r);
                        void *context,
                        adns_query *query_r);

-/* type must be _r_ptr or _r_ptr_raw.  _qf_search is ignored. */
+/* type must be _r_ptr or _r_ptr_raw.  _qf_search is ignored.
+ * addr->sa_family must be AF_INET or you get ENOSYS.
+ */

 
 void adns_finish(adns_state ads);
 /* You may call this even if you have queries outstanding;
 
 void adns_finish(adns_state ads);
 /* You may call this even if you have queries outstanding;


@@ -798,9 +800,12 @@ adns_status adns_rr_info(adns_rrtype type,
 
 const char *adns_strerror(adns_status st);
 const char *adns_errabbrev(adns_status st);
 
 const char *adns_strerror(adns_status st);
 const char *adns_errabbrev(adns_status st);

+const char *adns_errtypeabbrev(adns_status st);

 /* Like strerror but for adns_status values.  adns_errabbrev returns
  * the abbreviation of the error - eg, for adns_s_timeout it returns
 /* Like strerror but for adns_status values.  adns_errabbrev returns
  * the abbreviation of the error - eg, for adns_s_timeout it returns

- * "timeout".  You MUST NOT call these functions with status values
+ * "timeout".  adns_errtypeabbrev returns the abbreviation of the
+ * error class: ie, for values up to adns_s_max_XXX it will return the
+ * string XXX.  You MUST NOT call these functions with status values

  * not returned by the same adns library.
  */
 
  * not returned by the same adns library.
  */