diff --git a/spec/getdns-0.390.tgz b/spec/getdns-0.390.tgz deleted file mode 100644 index 4671ffce..00000000 Binary files a/spec/getdns-0.390.tgz and /dev/null differ diff --git a/spec/getdns-0.391.tgz b/spec/getdns-0.391.tgz new file mode 100644 index 00000000..0977bdd2 Binary files /dev/null and b/spec/getdns-0.391.tgz differ diff --git a/spec/getdns_core_only.c b/spec/getdns_core_only.c index 79ad366b..4e808aae 100644 --- a/spec/getdns_core_only.c +++ b/spec/getdns_core_only.c @@ -355,7 +355,7 @@ getdns_context_set_limit_outstanding_queries( getdns_return_t getdns_context_set_timeout( struct getdns_context *context, - unsigned int timeout + uint64_t timeout ) { UNUSED_PARAM(context); UNUSED_PARAM(timeout); return GETDNS_RETURN_GOOD; } diff --git a/spec/getdns_core_only.h b/spec/getdns_core_only.h index 1f790ab2..c27dc866 100644 --- a/spec/getdns_core_only.h +++ b/spec/getdns_core_only.h @@ -1,4 +1,4 @@ -/* Created at 2014-02-08-16-06-49*/ +/* Created at 2014-02-08-16-52-08*/ #ifndef GETDNS_H #define GETDNS_H @@ -32,7 +32,7 @@ typedef enum getdns_return_t { #define GETDNS_RETURN_GOOD_TEXT "Good" #define GETDNS_RETURN_GENERIC_ERROR_TEXT "Generic error" #define GETDNS_RETURN_BAD_DOMAIN_NAME_TEXT "Badly-formed domain name in first argument" -#define GETDNS_RETURN_BAD_CONTEXT_TEXT "Bad value for a context type" +#define GETDNS_RETURN_BAD_CONTEXT_TEXT "The context has internal deficiencies" #define GETDNS_RETURN_CONTEXT_UPDATE_FAIL_TEXT "Did not update the context" #define GETDNS_RETURN_UNKNOWN_TRANSACTION_TEXT "An attempt was made to cancel a callback with a transaction_id that is not recognized" #define GETDNS_RETURN_NO_SUCH_LIST_ITEM_TEXT "A helper function for lists had an index argument that was too high." diff --git a/spec/index.html b/spec/index.html index 356896c1..f316a6b2 100644 --- a/spec/index.html +++ b/spec/index.html @@ -97,7 +97,7 @@ tr.code { font-family: monospace }

Description of the getdns API

Paul Hoffman, Editor

-

Document version: "getdns Februari 2014"

+

Document version: "getdns February 2014"

This document describes a modern asynchronous DNS API. This new API is intended to be useful to application developers and operating system distributors as a way of making @@ -198,7 +198,7 @@ results are unpredictable.

The async getdns functions return GETDNS_RETURN_GOOD if the call was properly formatted. It returns GETDNS_RETURN_BAD_DOMAIN_NAME if the API determines that the name passed to -the function was bad, GETDNS_RETURN_BAD_CONTEXT if the context pointer is bad, +the function was bad, GETDNS_RETURN_BAD_CONTEXT if the context has internal deficiencies, GETDNS_RETURN_NO_SUCH_EXTENSION if one or more extensions do not exist, or GETDNS_RETURN_EXTENSION_MISFORMAT if the contents of one or more of the extensions is incorrect. All of the return values are given GETDNS_RETURN_BAD_DOMAIN_NAME

Badly-formed domain name in first argument

GETDNS_RETURN_BAD_CONTEXT

-

Bad value for a context type

+

The context has internal deficiencies

GETDNS_RETURN_CONTEXT_UPDATE_FAIL

Did not update the context

GETDNS_RETURN_UNKNOWN_TRANSACTION

@@ -1483,7 +1483,7 @@ function.

/* Set up the callback function, which will also do the processing of the results */ void this_callbackfn(struct getdns_context *this_context, - getdns_callback_type_t this_callback_type, + getdns_callback_type_t this_callback_type, struct getdns_dict *this_response, void *this_userarg, getdns_transaction_t this_transaction_id) @@ -1601,7 +1601,7 @@ their TTLs.

/* Set up the callback function, which will also do the processing of the results */ void this_callbackfn(struct getdns_context *this_context, - getdns_callback_type_t this_callback_type, + getdns_callback_type_t this_callback_type, struct getdns_dict *this_response, void *this_userarg, getdns_transaction_t this_transaction_id) @@ -2116,8 +2116,7 @@ for the API default context.

Setting specific values in a context are done with value-specific functions shown here. The setting functions all return either GETDNS_RETURN_GOOD for -success, GETDNS_RETURN_BAD_CONTEXT for trying to set a type with a value that -is not allowed, or GETDNS_RETURN_CONTEXT_UPDATE_FAIL for a failure to update the context.

+success or GETDNS_RETURN_CONTEXT_UPDATE_FAIL for a failure to update the context.

An application can be notified when the context is changed.

@@ -2426,7 +2425,7 @@ The response dicts inherit the custom memory management functions and the value

9. The Generated Files

-

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