[Stub-resolver] [getdns-api] Adding new getdns transport options

Sara Dickinson sara at sinodun.com
Thu Jun 18 19:16:31 CEST 2015


All, 

Based on recent discussions here is a last call request for review of new transport options to be added to section 8.3 of the official API at this time. 

getdns_context_set_dns_transport_list(
    getdns_context             *context,
    size_t                             transport_count, 
    getdns_transport_list_t *transports);

“The 'transports' array contains an ordered list of transports that will be used for DNS lookups. If only one transport value is specified it will be the only transport used. Should it not be available basic resolution will fail. Fallback transport options are specified by including multiple values in the list. The values are
GETDNS_TRANSPORT_UDP,
GETDNS_TRANSPORT_TCP,
GETDNS_TRANSPORT_TLS, or
GETDNS_TRANSPORT_STARTTLS

The default is a list containing GETDNS_TRANSPORT_UDP then GETDNS_TRANSPORT_TCP."

getdns_return_t
getdns_context_set_idle_timeout(
  getdns_context  *context,
  uint64_t        timeout
);

"Specifies number of milliseconds the API will leave an idle TCP, TLS or STARTTLS connection open for (idle means no outstanding responses and no pending queries). The default is 0."

Addition of other new transport options is deferred until a later date following more discussion. 

Regards

Sara.
_______________________________________________
stub-resolver mailing list
stub-resolver at lists.verisignlabs.com
https://lists.verisignlabs.com/mailman/listinfo/stub-resolver



More information about the spec mailing list