diff --git a/spec/getdns-0.374.tgz b/spec/getdns-0.374.tgz deleted file mode 100644 index b07e7b52..00000000 Binary files a/spec/getdns-0.374.tgz and /dev/null differ diff --git a/spec/getdns-0.375.tgz b/spec/getdns-0.375.tgz new file mode 100644 index 00000000..c660751e Binary files /dev/null and b/spec/getdns-0.375.tgz differ diff --git a/spec/getdns_core_only.c b/spec/getdns_core_only.c index d6819325..431b4f60 100644 --- a/spec/getdns_core_only.c +++ b/spec/getdns_core_only.c @@ -148,40 +148,40 @@ getdns_free_sync_request_memory( ) { UNUSED_PARAM(response); } -getdns_return_t getdns_list_get_length(struct getdns_list *this_list, size_t *answer) +getdns_return_t getdns_list_get_length(const struct getdns_list *this_list, size_t *answer) { UNUSED_PARAM(this_list); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_list_get_data_type(struct getdns_list *this_list, size_t index, getdns_data_type *answer) +getdns_return_t getdns_list_get_data_type(const struct getdns_list *this_list, size_t index, getdns_data_type *answer) { UNUSED_PARAM(this_list); UNUSED_PARAM(index); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_list_get_dict(struct getdns_list *this_list, size_t index, struct getdns_dict **answer) +getdns_return_t getdns_list_get_dict(const struct getdns_list *this_list, size_t index, struct getdns_dict **answer) { UNUSED_PARAM(this_list); UNUSED_PARAM(index); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_list_get_list(struct getdns_list *this_list, size_t index, struct getdns_list **answer) +getdns_return_t getdns_list_get_list(const struct getdns_list *this_list, size_t index, struct getdns_list **answer) { UNUSED_PARAM(this_list); UNUSED_PARAM(index); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_list_get_bindata(struct getdns_list *this_list, size_t index, struct getdns_bindata **answer) +getdns_return_t getdns_list_get_bindata(const struct getdns_list *this_list, size_t index, struct getdns_bindata **answer) { UNUSED_PARAM(this_list); UNUSED_PARAM(index); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_list_get_int(struct getdns_list *this_list, size_t index, uint32_t *answer) +getdns_return_t getdns_list_get_int(const struct getdns_list *this_list, size_t index, uint32_t *answer) { UNUSED_PARAM(this_list); UNUSED_PARAM(index); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_dict_get_names(struct getdns_dict *this_dict, struct getdns_list **answer) +getdns_return_t getdns_dict_get_names(const struct getdns_dict *this_dict, struct getdns_list **answer) { UNUSED_PARAM(this_dict); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_dict_get_data_type(struct getdns_dict *this_dict, char *name, getdns_data_type *answer) +getdns_return_t getdns_dict_get_data_type(const struct getdns_dict *this_dict, const char *name, getdns_data_type *answer) { UNUSED_PARAM(this_dict); UNUSED_PARAM(name); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_dict_get_dict(struct getdns_dict *this_dict, char *name, struct getdns_dict **answer) +getdns_return_t getdns_dict_get_dict(const struct getdns_dict *this_dict, const char *name, struct getdns_dict **answer) { UNUSED_PARAM(this_dict); UNUSED_PARAM(name); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_dict_get_list(struct getdns_dict *this_dict, char *name, struct getdns_list **answer) +getdns_return_t getdns_dict_get_list(const struct getdns_dict *this_dict, const char *name, struct getdns_list **answer) { UNUSED_PARAM(this_dict); UNUSED_PARAM(name); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_dict_get_bindata(struct getdns_dict *this_dict, char *name, struct getdns_bindata **answer) +getdns_return_t getdns_dict_get_bindata(const struct getdns_dict *this_dict, const char *name, struct getdns_bindata **answer) { UNUSED_PARAM(this_dict); UNUSED_PARAM(name); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } -getdns_return_t getdns_dict_get_int(struct getdns_dict *this_dict, char *name, uint32_t *answer) +getdns_return_t getdns_dict_get_int(const struct getdns_dict *this_dict, const char *name, uint32_t *answer) { UNUSED_PARAM(this_dict); UNUSED_PARAM(name); UNUSED_PARAM(answer); return GETDNS_RETURN_GOOD; } struct getdns_list * getdns_list_create() @@ -271,25 +271,25 @@ getdns_return_t getdns_dict_remove_name(struct getdns_dict *this_dict, char *nam char * getdns_convert_dns_name_to_fqdn( - char *name_from_dns_response + const char *name_from_dns_response ) { UNUSED_PARAM(name_from_dns_response); return NULL; } char * getdns_convert_fqdn_to_dns_name( - char *fqdn_as_string + const char *fqdn_as_string ) { UNUSED_PARAM(fqdn_as_string); return NULL; } char * getdns_convert_ulabel_to_alabel( - char *ulabel + const char *ulabel ) { UNUSED_PARAM(ulabel); return NULL; } char * getdns_convert_alabel_to_ulabel( - char *alabel + const char *alabel ) { UNUSED_PARAM(alabel); return NULL; } @@ -305,13 +305,13 @@ return GETDNS_RETURN_GOOD; } char * getdns_pretty_print_dict( - struct getdns_dict *some_dict + const struct getdns_dict *some_dict ) { UNUSED_PARAM(some_dict); return NULL; } char * getdns_display_ip_address( - struct getdns_bindata *bindata_of_ipv4_or_ipv6_address + const struct getdns_bindata *bindata_of_ipv4_or_ipv6_address ) { UNUSED_PARAM(bindata_of_ipv4_or_ipv6_address); return NULL; } diff --git a/spec/getdns_core_only.h b/spec/getdns_core_only.h index a73170f7..80777748 100644 --- a/spec/getdns_core_only.h +++ b/spec/getdns_core_only.h @@ -1,4 +1,4 @@ -/* Created at 2014-01-14-15-20-05*/ +/* Created at 2014-01-14-15-35-55*/ #ifndef GETDNS_H #define GETDNS_H @@ -260,21 +260,21 @@ struct getdns_list; /* Lists: get the length, get the data_type of the value at a given position, and get the data at a given position */ -getdns_return_t getdns_list_get_length(struct getdns_list *this_list, size_t *answer); -getdns_return_t getdns_list_get_data_type(struct getdns_list *this_list, size_t index, getdns_data_type *answer); -getdns_return_t getdns_list_get_dict(struct getdns_list *this_list, size_t index, struct getdns_dict **answer); -getdns_return_t getdns_list_get_list(struct getdns_list *this_list, size_t index, struct getdns_list **answer); -getdns_return_t getdns_list_get_bindata(struct getdns_list *this_list, size_t index, struct getdns_bindata **answer); -getdns_return_t getdns_list_get_int(struct getdns_list *this_list, size_t index, uint32_t *answer); +getdns_return_t getdns_list_get_length(const struct getdns_list *this_list, size_t *answer); +getdns_return_t getdns_list_get_data_type(const struct getdns_list *this_list, size_t index, getdns_data_type *answer); +getdns_return_t getdns_list_get_dict(const struct getdns_list *this_list, size_t index, struct getdns_dict **answer); +getdns_return_t getdns_list_get_list(const struct getdns_list *this_list, size_t index, struct getdns_list **answer); +getdns_return_t getdns_list_get_bindata(const struct getdns_list *this_list, size_t index, struct getdns_bindata **answer); +getdns_return_t getdns_list_get_int(const struct getdns_list *this_list, size_t index, uint32_t *answer); /* Dicts: get the list of names, get the data_type of the value at a given name, and get the data at a given name */ -getdns_return_t getdns_dict_get_names(struct getdns_dict *this_dict, struct getdns_list **answer); -getdns_return_t getdns_dict_get_data_type(struct getdns_dict *this_dict, char *name, getdns_data_type *answer); -getdns_return_t getdns_dict_get_dict(struct getdns_dict *this_dict, char *name, struct getdns_dict **answer); -getdns_return_t getdns_dict_get_list(struct getdns_dict *this_dict, char *name, struct getdns_list **answer); -getdns_return_t getdns_dict_get_bindata(struct getdns_dict *this_dict, char *name, struct getdns_bindata **answer); -getdns_return_t getdns_dict_get_int(struct getdns_dict *this_dict, char *name, uint32_t *answer); +getdns_return_t getdns_dict_get_names(const struct getdns_dict *this_dict, struct getdns_list **answer); +getdns_return_t getdns_dict_get_data_type(const struct getdns_dict *this_dict, const char *name, getdns_data_type *answer); +getdns_return_t getdns_dict_get_dict(const struct getdns_dict *this_dict, const char *name, struct getdns_dict **answer); +getdns_return_t getdns_dict_get_list(const struct getdns_dict *this_dict, const char *name, struct getdns_list **answer); +getdns_return_t getdns_dict_get_bindata(const struct getdns_dict *this_dict, const char *name, struct getdns_bindata **answer); +getdns_return_t getdns_dict_get_int(const struct getdns_dict *this_dict, const char *name, uint32_t *answer); /* Lists: create, destroy, and set the data at a given position */ @@ -440,22 +440,22 @@ getdns_service_sync( char * getdns_convert_dns_name_to_fqdn( - char *name_from_dns_response + const char *name_from_dns_response ); char * getdns_convert_fqdn_to_dns_name( - char *fqdn_as_string + const char *fqdn_as_string ); char * getdns_convert_ulabel_to_alabel( - char *ulabel + const char *ulabel ); char * getdns_convert_alabel_to_ulabel( - char *alabel + const char *alabel ); getdns_return_t @@ -467,12 +467,12 @@ getdns_validate_dnssec( char * getdns_pretty_print_dict( - struct getdns_dict *some_dict + const struct getdns_dict *some_dict ); char * getdns_display_ip_address( - struct getdns_bindata *bindata_of_ipv4_or_ipv6_address + const struct getdns_bindata *bindata_of_ipv4_or_ipv6_address ); getdns_return_t diff --git a/spec/index.html b/spec/index.html index dbcb4c7d..88839ddf 100644 --- a/spec/index.html +++ b/spec/index.html @@ -524,21 +524,21 @@ name-value pairs in a dict is not important.
/* Lists: get the length, get the data_type of the value at a given position, and get the data at a given position */ -getdns_return_t getdns_list_get_length(struct getdns_list *this_list, size_t *answer); -getdns_return_t getdns_list_get_data_type(struct getdns_list *this_list, size_t index, getdns_data_type *answer); -getdns_return_t getdns_list_get_dict(struct getdns_list *this_list, size_t index, struct getdns_dict **answer); -getdns_return_t getdns_list_get_list(struct getdns_list *this_list, size_t index, struct getdns_list **answer); -getdns_return_t getdns_list_get_bindata(struct getdns_list *this_list, size_t index, struct getdns_bindata **answer); -getdns_return_t getdns_list_get_int(struct getdns_list *this_list, size_t index, uint32_t *answer); +getdns_return_t getdns_list_get_length(const struct getdns_list *this_list, size_t *answer); +getdns_return_t getdns_list_get_data_type(const struct getdns_list *this_list, size_t index, getdns_data_type *answer); +getdns_return_t getdns_list_get_dict(const struct getdns_list *this_list, size_t index, struct getdns_dict **answer); +getdns_return_t getdns_list_get_list(const struct getdns_list *this_list, size_t index, struct getdns_list **answer); +getdns_return_t getdns_list_get_bindata(const struct getdns_list *this_list, size_t index, struct getdns_bindata **answer); +getdns_return_t getdns_list_get_int(const struct getdns_list *this_list, size_t index, uint32_t *answer); /* Dicts: get the list of names, get the data_type of the value at a given name, and get the data at a given name */ -getdns_return_t getdns_dict_get_names(struct getdns_dict *this_dict, struct getdns_list **answer); -getdns_return_t getdns_dict_get_data_type(struct getdns_dict *this_dict, char *name, getdns_data_type *answer); -getdns_return_t getdns_dict_get_dict(struct getdns_dict *this_dict, char *name, struct getdns_dict **answer); -getdns_return_t getdns_dict_get_list(struct getdns_dict *this_dict, char *name, struct getdns_list **answer); -getdns_return_t getdns_dict_get_bindata(struct getdns_dict *this_dict, char *name, struct getdns_bindata **answer); -getdns_return_t getdns_dict_get_int(struct getdns_dict *this_dict, char *name, uint32_t *answer); +getdns_return_t getdns_dict_get_names(const struct getdns_dict *this_dict, struct getdns_list **answer); +getdns_return_t getdns_dict_get_data_type(const struct getdns_dict *this_dict, const char *name, getdns_data_type *answer); +getdns_return_t getdns_dict_get_dict(const struct getdns_dict *this_dict, const char *name, struct getdns_dict **answer); +getdns_return_t getdns_dict_get_list(const struct getdns_dict *this_dict, const char *name, struct getdns_list **answer); +getdns_return_t getdns_dict_get_bindata(const struct getdns_dict *this_dict, const char *name, struct getdns_bindata **answer); +getdns_return_t getdns_dict_get_int(const struct getdns_dict *this_dict, const char *name, uint32_t *answer);

All of these helper getter functions return GETDNS_RETURN_GOOD if the call is successful. @@ -1052,12 +1052,12 @@ string in FQDN format to bytes in DNS format.

char * getdns_convert_dns_name_to_fqdn( - char *name_from_dns_response + const char *name_from_dns_response ); char * getdns_convert_fqdn_to_dns_name( - char *fqdn_as_string + const char *fqdn_as_string );
@@ -1804,12 +1804,12 @@ encoding and their ASCII encoding. They follow the rules for IDNA 2008 described RFC 5890-5892.

char * getdns_convert_ulabel_to_alabel( - char *ulabel + const char *ulabel );
char * getdns_convert_alabel_to_ulabel( - char *alabel + const char *alabel );
@@ -1833,7 +1833,7 @@ will use the resource records in bundle_of_support_records and the
char * getdns_pretty_print_dict( - struct getdns_dict *some_dict + const struct getdns_dict *some_dict );

This returns a string that is the nicely-formatted version @@ -1842,7 +1842,7 @@ of the dict and all of the named elements in it.

char * getdns_display_ip_address( - struct getdns_bindata *bindata_of_ipv4_or_ipv6_address + const struct getdns_bindata *bindata_of_ipv4_or_ipv6_address );

This returns a string that is the nicely-formatted version @@ -2210,7 +2210,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