manpagez: man pages & more
man ares_set_socket_configure_callback(3)
Home | html | info | man
ares_set_socket_configure_callback(3)                 Library Functions Manual


NAME

       ares_set_socket_configure_callback - Set a socket configuration
       callback


SYNOPSIS

       #include <ares.h>

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

       void ares_set_socket_configure_callback(ares_channel_t *channel,
                                               ares_sock_config_callback callback,
                                               void *userdata)


DESCRIPTION

       This function sets a callback in the given ares channel handle. Cannot
       be used when ARES_OPT_EVENT_THREAD is passed to ares_init_options(3).

       This callback function will be invoked after the socket has been
       created, but before it has been connected to the remote server, which
       is an ideal time to configure various socket options.  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_callback(3)


AVAILABILITY

       ares_set_socket_configure_callback(3) was added in c-ares 1.11.0


                                  6 Feb 2016
                                         ares_set_socket_configure_callback(3)

c-ares 1.30.0 - Generated Thu Jun 13 11:50:23 CDT 2024
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.