[API 0.401] getdns_root_trust_anchor function

spec/index.html

@@ -1485,7 +1485,7 @@ function.</p>
 
 <span class="cm">/* Set up the callback function, which will also do the processing of the results */</span>
 <span class="kt">void</span> <span class="nf">this_callbackfn</span><span class="p">(</span><span class="n">getdns_context</span> <span class="o">*</span><span class="n">this_context</span><span class="p">,</span>
-                     <span class="n">getdns_callback_type_t</span> <span class="n">this_callback_type</span><span class="p">,</span>
+                     <span class="kt">getdns_callback_type_t</span> <span class="n">this_callback_type</span><span class="p">,</span>
                      <span class="n">getdns_dict</span> <span class="o">*</span><span class="n">this_response</span><span class="p">,</span> 
                      <span class="kt">void</span> <span class="o">*</span><span class="n">this_userarg</span><span class="p">,</span>
                      <span class="kt">getdns_transaction_t</span> <span class="n">this_transaction_id</span><span class="p">)</span>
@@ -1603,7 +1603,7 @@ their TTLs.</p>
 
 <span class="cm">/* Set up the callback function, which will also do the processing of the results */</span>
 <span class="kt">void</span> <span class="nf">this_callbackfn</span><span class="p">(</span><span class="n">getdns_context</span> <span class="o">*</span><span class="n">this_context</span><span class="p">,</span>
-                     <span class="n">getdns_callback_type_t</span> <span class="n">this_callback_type</span><span class="p">,</span>
+                     <span class="kt">getdns_callback_type_t</span> <span class="n">this_callback_type</span><span class="p">,</span>
                      <span class="n">getdns_dict</span> <span class="o">*</span><span class="n">this_response</span><span class="p">,</span> 
                      <span class="kt">void</span> <span class="o">*</span><span class="n">this_userarg</span><span class="p">,</span>
                      <span class="kt">getdns_transaction_t</span> <span class="n">this_transaction_id</span><span class="p">)</span>
@@ -2043,6 +2043,21 @@ The API will use the resource records in <code>bundle_of_support_records</code>
 The function returns one of <code>GETDNS_DNSSEC_SECURE</code>, <code>GETDNS_DNSSEC_BOGUS</code>, <code>GETDNS_DNSSEC_INDETERMINATE</code>, or <code>GETDNS_DNSSEC_INSECURE</code>.
 </p>
 
+<p class=cont>
+The default list of trust anchor records that is used by the library to validate DNSSEC can
+be retrieved by using the <code>getdns_root_trust_anchor</code> helper function.</p>
+<div class=forh>getdns_list *
+getdns_root_trust_anchor(
+  time_t *utc_date_of_anchor
+);
+</div>
+<p class=cont>
+When there are no default trust anchors <code>NULL</code> is returned.
+Upon successful return, the variable of type <code>time_t</code>, referenced by
+<code>utc_date_of_anchor</code> is set to the number of seconds since epoch
+the trust anchors were obtained.
+</p>
+
 <p>There are two functions that help process data:</p>
 
 <div class=forh>
@@ -2428,7 +2443,7 @@ The response dicts inherit the custom memory management functions and the value
 
 <h1>9. The Generated Files</h1>
 
-<p>There is <a href="getdns-0.400.tgz">a tarball</a> that includes the .h files,
+<p>There is <a href="getdns-0.401.tgz">a tarball</a> that includes the .h files,
 the examples, and so on. The examples all make, even though there is no API implementation, based
 on a pseudo-implementation in the tarball; see make-examples-PLATFORM.sh. Note that this currently builds fine
 on the Macintosh and Ubuntu; help is definitely appreciated on making the build process