GNURLOPT_USERAGENT(3)

✨ NAME ✨

Okay so welcome to the GNURLOPT_USERAGENT(3) page, bestie — it's part of the curl_easy_setopt options crew, and it's here to explain how to set the HTTP user-agent header. Main character energy fr fr. 💅

CURLOPT_USERAGENT — set the HTTP user-agent header. ✨

---

🎀 SYNOPSIS 🎀

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERAGENT, char *ua);

---

💖 DESCRIPTION 💖

You pass a pointer to a null-terminated string as the parameter, bestie. That string gets used to set the User-Agent: header in the HTTP request sent to the remote server. No cap. This can be used to fool servers or scripts. You can also set any custom header with CURLOPT_HTTPHEADER(3) — iykyk.

The application does not have to keep the string around after setting this option. Obsessed with that convenience, honestly. 🫶

---

🌸 DEFAULT 🌸

NULL — no User-Agent: header is used by default. So if you don't set it, it's giving mystery. 💀

---

🦋 PROTOCOLS 🦋

HTTP, HTTPS — that's the whole vibe check. ✨

---

🔥 EXAMPLE 🔥

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

  curl_easy_setopt(curl, CURLOPT_USERAGENT, "Dark Secret Ninja/1.0");

  curl_easy_perform(curl);
}

Slay, now your client is out here with Dark Secret Ninja/1.0 as its user-agent. Secret ninja energy periodt. 🥷💜

---

⭐ AVAILABILITY ⭐

As long as HTTP is supported. That's it, that's the availability. 🌈

---

💖 RETURN VALUE 💖

Returns CURLE_OK if HTTP is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. So yeah, check your return value, bestie — no cap. 🔥

---

🌈 SEE ALSO 🌈

• CURLOPT_REFERER(3) — another reference in the group chat. 🫶
• CURLOPT_HTTPHEADER(3) — custom headers live here too. ✨

---

Stay hydrated, bestie 🫶 — this page is serving libcurl 7.37.0, dated 17 Jun 2014. Byeee! 💅✨