GNURLOPT_RANDOM_FILE(3)

🦋 GNURLOPT_RANDOM_FILE(3) — curl_easy_setopt options 🦋

okay so welcome to the GNURLOPT_RANDOM_FILE(3) manual page, bestie — it lives in the curl_easy_setopt options section and it's here to explain how to point curl at a source of random data. no cap, it's a short one, so let's go 💅

---

✨ NAME ✨

CURLOPT_RANDOM_FILE — specify a source for random data. 💖

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANDOM_FILE, char
*path);

🎀 DESCRIPTION 🎀

You're passing a char * that points at a null-terminated file name, bestie. curl might read from that file to seed the random engine for SSL and more. 🔥

The application does not have to keep the string around after setting this option — so you can let it go, no strings attached. 🫶

💜 DEFAULT 💜

• NULL, not used. literally unused, not even a vibe. 🙈

🌈 PROTOCOLS 🌈

• All — all of them. every protocol is invited to the party. 👑

⭐ EXAMPLE ⭐

okay here's the example, copy-paste princess:

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_RANDOM_FILE, "junk.txt");
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

🦋 AVAILABILITY 🦋

Always — she's always available, periodt. ✨

💖 RETURN VALUE 💖

Returns CURLE_OK on success, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. 😭

🍓 SEE ALSO 🍓

• CURLOPT_EGDSOCKET(3), — yep, that's the see-also bestie. 🫶

---

mwah 💋 this was GNURLOPT_RANDOM_FILE(3) from libcurl 7.37.0, dated 17 Jun 2014 — iconic, no notes. 🌟