diff --git a/spec/getdns-0.402.tgz b/spec/getdns-0.402.tgz deleted file mode 100644 index 74efce8d..00000000 Binary files a/spec/getdns-0.402.tgz and /dev/null differ diff --git a/spec/getdns-0.403.tgz b/spec/getdns-0.403.tgz new file mode 100644 index 00000000..d9b4f0f6 Binary files /dev/null and b/spec/getdns-0.403.tgz differ diff --git a/spec/index.html b/spec/index.html index 6fd93f74..609f25f2 100644 --- a/spec/index.html +++ b/spec/index.html @@ -664,8 +664,6 @@ getdns_dict_destroy(this_extensions);
specify_class
return_api_information
return_call_debugging
An application might want to see information about the API itself. Use the
-return_api_information
extension. An application that wants to get this information
-before a "real" query is issued can add this extension to a PTR query for 127.0.0.1.
-The extension's value (an int) is set to
-GETDNS_EXTENSION_TRUE
to add the following to the top level of the response object:
version_string
(a bindata) represents the version string for this version of the DNS
-API.implementation_string
(a bindata) is a string set by the API implementer. It might
-be human-readable, and it might have information in it useful to an application developer (but it doesn't
-have to).resolver_type
(an int) is the type of resolver that the API is acting as in this context:
-GETDNS_RESOLUTION_RECURSING
or GETDNS_RESOLUTION_STUB
(it will be
-a recursing resolver unless the application changed this in a context.all_context
(a dict) with names for all the types of context. This can be used with
-getdns_pretty_print_dict() for debugging.An application might want to see debugging information for queries such as the length of time it
takes for each query to return to the API. Use the return_call_debugging
extension. The
extension's value (an int) is set to GETDNS_EXTENSION_TRUE
to add the name
@@ -1004,7 +978,8 @@ They are: id
, qr
, opcode
, aa
Resource records are a bit different than headers and question sections in that the RDATA portion
often has its own structure. The other names in the resource record dicts are name
(a
bindata), type
(an int), class
(an int), ttl
(an int) and
-rdata
(a dict); there is no name equivalent to the RDLENGTH field.
rdata
(a dict); there is no name equivalent to the RDLENGTH field.
+The OPT
resource record is an exception. It does not have a class
and a ttl
names, but in stead provides udp_payload_size
(an int), extended_rcode
(an int), version
(an int), do
(an int), and z
(an int).
The rdata
dict has different names for each response type. There is a complete list of the types defined in the API. For names that end in
@@ -2439,9 +2414,36 @@ The response dicts inherit the custom memory management functions and the value
Change related to getdns_context_set_timeout
An application might want to see information about the API itself and inspect the current context.
+Use the getdns_context_get_api_information
function.
The returned getdns_dict
will contain the following name/value pairs:
version_string
(a bindata) represents the version string for this version of the DNS
+API.implementation_string
(a bindata) is a string set by the API implementer. It might
+be human-readable, and it might have information in it useful to an application developer (but it doesn't
+have to).resolver_type
(an int) is the type of resolver that the API is acting as in this context:
+GETDNS_RESOLUTION_RECURSING
or GETDNS_RESOLUTION_STUB
(it will be
+a recursing resolver unless the application changed this in a context.all_context
(a dict) with names for all the types of context. This can be used with
+getdns_pretty_print_dict() for debugging.There is a tarball that includes the .h files, +
There is a tarball 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