GNURLOPT_R...START_DATA(3)

🎀 NAME 🎀

Okay bestie, this is the curl_easy_setopt options manual page from gnurl — the one with the header GNURLOPT_R...START_DATA(3) — and it is literally about CURLOPT_RESOLVER_START_DATA, aka the custom pointer you pass to the resolver start callback. 💅

---

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RESOLVER_START_DATA,
       void *pointer);

---

🦋 DESCRIPTION 🦋

You pass in a pointer, and libcurl is gonna leave that pointer completely untouched — no cap, untouched — then hand it over as the third argument in the resolver start callback that you set with CURLOPT_RESOLVER_START_FUNCTION(3). That's the whole vibe. 🫶

---

🌸 DEFAULT 🌸

NULL

---

🌈 PROTOCOLS 🌈

All of them, bestie. Literally all.

---

🍓 EXAMPLE 🍓

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, "http://example.com");
  curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

---

⭐ AVAILABILITY ⭐

Added in 7.59.0. iconic behavior, honestly.

---

👑 RETURN VALUE 👑

Returns CURLE_OK. slay.

---

💜 SEE ALSO 💜

• CURLOPT_RESOLVER_START_FUNCTION(3)

---

Signed, sealed, and delivered by libcurl 7.59.0 on 14 Feb 2018, with the footer tag GNURLOPT_R...START_DATA(3) — periodt. 💖✨