| .\" $Id$ |
| .\" |
| .TH ARES_SET_SOCKET_CALLBACK 3 "2 Dec 2008" |
| .SH NAME |
| ares_set_socket_callback \- Set a socket creation callback |
| .SH SYNOPSIS |
| .nf |
| int ares_set_socket_callback(ares_channel \fIchannel\fP, |
| ares_sock_create_callback \fIcallback\fP, |
| void *\fIuserdata\fP) |
| .fi |
| .SH DESCRIPTION |
| This function sets a \fIcallback\fP 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 use the standard ares error codes to signal errors |
| back. Returned errors will abort the ares operation. |
| .SH SEE ALSO |
| .BR ares_init_options (3) |
| .SH AVAILABILITY |
| ares_set_socket_callback(3) was added in c-ares 1.6.0 |
| .SH AUTHOR |
| Gregor Jasny |
| |