ares_set_socket_callback - Man Page

Set a socket creation callback

Synopsis

#include <ares.h>

typedef int (*ares_sock_create_callback)(ares_socket_t socket_fd,
                                         int type,
                                         void *userdata)

void ares_set_socket_callback(ares_channel_t *channel,
                              ares_sock_create_callback callback,
                              void *userdata)

cc file.c -lcares

Description

This function sets a callback in the given ares channel handle. This callback function will be invoked after the socket has been created, and connected to the remote server. The callback must return ARES_SUCCESS if things are fine, or return -1 to signal an error. A returned error will abort the ares operation.

See Also

ares_init_options(3), ares_set_socket_configure_callback(3)

Availability

ares_set_socket_callback(3) was added in c-ares 1.6.0

Referenced By

ares_set_socket_configure_callback(3).

20 Nov 2009