GNURLOPT_PROXYAUTH(3)

💅 GNURLOPT_PROXYAUTH(3) — the curl_easy_setopt options girlies 💅

okay so bestie, you're in the gnurl corner of the curl_easy_setopt options family, and this one is all about telling libcurl which HTTP auth method(s) to use when it's talking to your proxy. no cap, it's a vibe. ✨

---

🌸 NAME 🌸

CURLOPT_PROXYAUTH — set the HTTP proxy authentication methods to try 🫶

---

🦋 SYNOPSIS 🦋

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYAUTH, long
bitmask);

---

🔥 DESCRIPTION 🔥

so you pass a long as the parameter, and it's set to a bitmask — yes babe, a bitmask, and it tells libcurl which HTTP authentication method(s) you want it to use for your proxy authentication. 💅

here's the tea: if more than one bit is set, libcurl will first query the site to see what authentication methods it supports, and then pick the best one you allow it to use. the way it's out here doing a whole vibe check on the proxy before committing? iconic. but ngl, for some methods this will induce an extra network round-trip — so don't act surprised 😭

to set the actual name and password, you use the CURLOPT_PROXYUSERPWD(3) option. that's where the credentials live, periodt.

and the bitmask itself? you can construct it by or'ing together the bits that are fully listed and described in the CURLOPT_HTTPAUTH(3) man page. go read that one, iykyk. 📚

---

🎀 DEFAULT 🎀

CURLAUTH_BASIC

like, that's the one you get if you don't say anything. the default main character. 👑

---

🌈 PROTOCOLS 🌈

HTTP

that's it. that's the list. 🦋

---

⭐ EXAMPLE ⭐

CURL *curl = curl_easy_init();
if(curl) {
  CURLcode ret;
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  /* use this proxy */
  curl_easy_setopt(curl, CURLOPT_PROXY, "http://local.example.com:1080");
  /* allow whatever auth the proxy speaks */
  curl_easy_setopt(curl, CURLOPT_PROXYAUTH, CURLAUTH_ANY);
  /* set the proxy credentials */
  curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, "james:007");
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

like yes, CURLAUTH_ANY is giving "i trust the proxy to pick, i'm flexible, i'm chill" energy and honestly? we love a low-maintenance queen. 🧚 and the credentials are literally james:007. iconic spy moment. 🍓

---

💜 AVAILABILITY 💜

Added in 7.10.7 — so she's been on the scene for a minute, she's a veteran. 👑

---

🫶 RETURN VALUE 🫶

• Returns CURLE_OK if the option is supported ✅
• Returns CURLE_UNKNOWN_OPTION if not 🙈
• Or returns CURLE_NOT_BUILT_IN if the bitmask specified no supported authentication methods 💀

so like, read your return codes babes, don't just ignore them and then be confused later. 😭

---

🌸 SEE ALSO 🌸

• CURLOPT_PROXY(3)
• CURLOPT_PROXYTYPE(3)
• CURLOPT_PROXYUSERPWD(3)
• CURLOPT_PROXYPORT(3)

---

⚠️ tiny reminder that this is the gnurl page for CURLOPT_PROXYAUTH, and it's an HTTP-proxy thing — don't go pointing it at other protocols and expecting magic, because the PROTOCOLS section fr fr just says HTTP.

k bye bestie, go authenticate that proxy and slay 💖✨

— from the libcurl 7.37.0 girlies, dated 19 Jun 2014, with love (and a lot of emoji) 🎀🦋💅