GNURLOPT_D..._ADDRESSES(3)

💅 GNURLOPT_D..._ADDRESSES(3) — CURLOPT_DNS_SHUFFLE_ADDRESSES 💅

okay so bestie, this is a page from the curl_easy_setopt options corner of the gnurl manual, and it's genuinely one of the slayest little flags ever. like, it's short, it's chaotic, it's giving "shuffle button on your Spotify" but for IP addresses. iykyk. 🎀

---

✨ NAME ✨

CURLOPT_DNS_SHUFFLE_ADDRESSES — Shuffle addresses when a hostname returns more than one 🌈

---

🦋 SYNOPSIS 🦋

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_SHUFFLE_ADDRESSES, long onoff);

---

💖 DESCRIPTION 💖

So here's the tea ☕: when a name gets resolved and more than one IP address comes back, this option shuffles the order of all the returned addresses so they get used in a random order. literally just ✨randomized✨. This is similar to the ordering behavior of gethostbyname which is no longer used on most platforms (rip bozo 💀).

Important vibe check: addresses will not be reshuffled if a name resolution is completed using the DNS cache. no cap. CURLOPT_DNS_CACHE_TIMEOUT(3) can be used together with this option to reduce the DNS cache timeout or disable caching entirely if frequent reshuffling is needed. (so if you want constant chaos, turn the cache down or off, bestie 🫶)

And since the addresses returned will be reordered randomly, their order will not be in accordance with RFC 3484 or any other deterministic order that may be generated by the system's name resolution implementation. 😭 This may have performance impacts and may cause IPv4 to be used before IPv6 or vice versa. so like, it's iconic but it's also a little unhinged, and the performance is lowkey affected. not me warning you twice 💀

---

🎀 DEFAULT 🎀

0 (disabled) — the shuffle is off until you say otherwise, queen 👑

---

🌸 PROTOCOLS 🌸

All 💯

---

🔥 EXAMPLE 🔥

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
  curl_easy_setopt(curl, CURLOPT_DNS_SHUFFLE_ADDRESSES, 1L);

  curl_easy_perform(curl);

  /* always cleanup */
  curl_easy_cleanup(curl);
}

look at her go 🧚 she's shuffling! she's performing! she's cleaning up after herself because she's a responsible main character ✨

---

🦄 AVAILABILITY 🦄

Added in 7.60.0 — so she's been serving looks since 2018, periodt 💅

---

⭐ RETURN VALUE ⭐

CURLE_OK or an error such as CURLE_UNKNOWN_OPTION. 💖

(so like, either it slays or it tells you the option was unknown. either way, no mystery.)

---

👑 SEE ALSO 👑

• CURLOPT_DNS_CACHE_TIMEOUT(3)
• CURLOPT_IPRESOLVE(3),

---

okay that's the whole page, bestie!! now go forth and shuffle responsibly 🌸✨

libcurl 7.60.0 · 3 March 2018 🎀 mwah, love u, bye 💜