bionic (3) ares_set_socket_configure_callback.3.gz

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 channel,
                                    ares_sock_config_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, 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

AUTHOR

       Andrew Ayer

                                                   6 Feb 2016              ARES_SET_SOCKET_CONFIGURE_CALLBACK(3)