Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ARES_SET_S...E_CALLBACK(3) Library Functions Manual ARES_SET_S...E_CALLBACK(3)

NAME
       ares_set_socket_configure_callback  -  Set a socket configuration call-
       back

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 cre-
       ated, 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  er-
       ror. 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_S...E_CALLBACK(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ares_set_socket_configure_callback&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help