GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CURLOPT_RESOLVER_START_FUNCTION(3) curl_easy_setopt options CURLOPT_RESOLVER_START_FUNCTION(3)

CURLOPT_RESOLVER_START_FUNCTION - callback called before a new name resolve is started

#include <curl/curl.h>
int resolver_start_cb(void *resolver_state, void *reserved, void *userdata);
CURLcode curl_easy_setopt(CURL *handle,
                          CURLOPT_RESOLVER_START_FUNCTION,
                          resolver_start_cb);

Pass a pointer to your callback function, which should match the prototype shown above.

This callback function gets called by libcurl every time before a new resolve request is started.

resolver_state points to a backend-specific resolver state. Currently only the ares resolver backend has a resolver state. It can be used to set up any desired option on the ares channel before it's used, for example setting up socket callback options.

reserved is reserved.

userdata is the user pointer set with the CURLOPT_RESOLVER_START_DATA(3) option.

The callback must return 0 on success. Returning a non-zero value will cause the resolve to fail.

NULL (No callback)

All

static int resolver_start_cb(void *resolver_state, void *reserved,
                             void *userdata)
{
  (void)reserved;
  printf("Received resolver_state=%p userdata=%p\n",
         resolver_state, userdata);
  return 0;
}
CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_RESOLVER_START_FUNCTION, resolver_start_cb);
  curl_easy_setopt(curl, CURLOPT_RESOLVER_START_DATA, curl);
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
  curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

Added in 7.59.0

Returns CURLE_OK

CURLOPT_RESOLVER_START_DATA(3)
September 8, 2021 libcurl 7.83.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.