CURLOPT_VERBOSE(3)

💅 CURLOPT_VERBOSE — verbose mode, bestie ✨

Okay so this is a page from the libcurl manual (that's the library functions manual, iykyk) and it's all about CURLOPT_VERBOSE. Buckle up, it's a good one 🎀

✨ SYNOPSIS ✨

#include <curl/curl.h>

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

🌸 DESCRIPTION 🌸

So the whole vibe: set that onoff param to 1 and the library will spill a lot of verbose tea ☕ about what it's doing on this handle. It's genuinely so useful for debugging libcurl and/or whichever protocol you're messing with, and for just… understanding what's going on. The verbose info gets sent to stderr, or to whatever stream you set with CURLOPT_STDERR(3) 💖

Bestie, listen — you hardly ever want this turned on in production use, like fr fr. You basically always want this when you're debugging or reporting problems. That's the moment. 👑

And if you also want all the protocol data that's being sent and received? Consider using the CURLOPT_DEBUGFUNCTION(3), bestie. 🦋

WARNING this may show sensitive contents from headers and data. No cap, that's a real one — treat it with care 😭🔒

💅 DEFAULT 💅

0, meaning disabled, as in off, as in not enabled, as in the verbose mode is not currently vibing.

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols. All of them. Every single one. Slay. ✨

🎀 EXAMPLE 🎀

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

    /* ask libcurl to show us the verbose output */
    curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

    /* Perform the request */
    curl_easy_perform(curl);
  }
}

🦋 AVAILABILITY 🦋

Added in curl 7.1 — she's been iconic since day one, honestly 💜

⭐ RETURN VALUE ⭐

curl_easy_setopt(3) returns a CURLcode indicating success or error, bestie.

CURLE_OK (0) means everything was OK 🫶, non-zero means an error occurred 😭 — see libcurl-errors(3) for the full rundown.

👑 SEE ALSO 👑

• CURLOPT_DEBUGFUNCTION(3)
• CURLOPT_ERRORBUFFER(3)
• CURLOPT_STDERR(3)
• curl_global_trace(3)

---

And that's the whole page, babes 💖 straight from the libcurl manual, dated 2026-10-12, version vibes and all. Go forth and debug, you gorgeous creature 🧚🌸💅