Name

ares_set_query_enqueue_cb - Function for setting a callback which is triggered when a new query is enqueued on the wire.

Synopsis

#include <ares.h>
 
typedef void (*ares_query_enqueue_cb)(void *data);
 
void ares_set_query_enqueue_cb(
  ares_channel_t        *channel,
  ares_query_enqueue_cb  callback,
  void                  *user_data);
 

Description

The ares_set_query_enqueue_cb function sets a callback function callback in the given ares channel handle channel that is invoked whenever there is a new query enqueued onto the wire. This can be used to wake an event subsystem which may otherwise only be notified of socket state changes, but needs a notification to be able to calculate query timeouts.

This function may be called with the callback set to NULL to remove the callback.

Availability

This function was first introduced in c-ares version 1.35.0.

See also

ares_init_options(3)

This HTML page was made with roffit.