Asynchronous API functions

Functions

getdns_return_t getdns_general (getdns_context *context, const char *name, uint16_t request_type, getdns_dict *extensions, void *userarg, getdns_transaction_t *transaction_id, getdns_callback_t callbackfn)
 
getdns_return_t getdns_address (getdns_context *context, const char *name, getdns_dict *extensions, void *userarg, getdns_transaction_t *transaction_id, getdns_callback_t callbackfn)
 
getdns_return_t getdns_hostname (getdns_context *context, getdns_dict *address, getdns_dict *extensions, void *userarg, getdns_transaction_t *transaction_id, getdns_callback_t callbackfn)
 
getdns_return_t getdns_service (getdns_context *context, const char *name, getdns_dict *extensions, void *userarg, getdns_transaction_t *transaction_id, getdns_callback_t callbackfn)
 

Detailed Description

Function Documentation

getdns_return_t getdns_general ( getdns_context context,
const char *  name,
uint16_t  request_type,
getdns_dict extensions,
void *  userarg,
getdns_transaction_t transaction_id,
getdns_callback_t  callbackfn 
)

retrieve general DNS data

Parameters
contextpointer to a previously created context to be used for this call
namethe ASCII based domain name to lookup
request_typeRR type for the query, e.g. GETDNS_RR_TYPE_NS
extensionsdict data structures, NULL to use no extensions
userargvoid* returned to the callback untouched
[out]transaction_idid used to identify the callback, NULL is ignored
callbackfncallback function defined by the application
Returns
GETDNS_RETURN_GOOD on success
getdns_return_t getdns_address ( getdns_context context,
const char *  name,
getdns_dict extensions,
void *  userarg,
getdns_transaction_t transaction_id,
getdns_callback_t  callbackfn 
)

retrieve address assigned to a DNS name

Parameters
contextpointer to a previously created context to be used for this call
namethe ASCII based domain name to lookup
extensionsdict data structures, NULL to use no extensions
userargvoid* returned to the callback untouched
[out]transaction_idid used to identify the callback, NULL is ignored
callbackfncallback function defined by the application
Returns
GETDNS_RETURN_GOOD on success
getdns_return_t getdns_hostname ( getdns_context context,
getdns_dict address,
getdns_dict extensions,
void *  userarg,
getdns_transaction_t transaction_id,
getdns_callback_t  callbackfn 
)

retrieve hostname assigned to an IP address

Parameters
contextpointer to a previously created context to be used for this call
addressthe address to look up
extensionsdict data structures, NULL to use no extensions
userargvoid* returned to the callback untouched
[out]transaction_idid used to identify the callback, NULL is ignored
callbackfncallback function defined by the application
Returns
GETDNS_RETURN_GOOD on success
getdns_return_t getdns_service ( getdns_context context,
const char *  name,
getdns_dict extensions,
void *  userarg,
getdns_transaction_t transaction_id,
getdns_callback_t  callbackfn 
)

retrieve a service assigned to a DNS name

Parameters
contextpointer to a previously created context to be used for this call
namethe ASCII based domain name to lookup
extensionsdict data structures, NULL to use no extensions
userargvoid* returned to the callback untouched
[out]transaction_idid used to identify the callback, NULL is ignored
callbackfncallback function defined by the application
Returns
GETDNS_RETURN_GOOD on success