CURLOPT_STDERR - Man Page

redirect stderr to another stream

Synopsis

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STDERR, FILE *stream);

Description

Pass a FILE * as parameter. Tell libcurl to use this stream instead of stderr when showing the progress meter and displaying CURLOPT_VERBOSE(3) data.

If you are using libcurl as a Windows DLL, this option causes an exception and a crash in the library since it cannot access a FILE * passed on from the application. A work-around is to instead use CURLOPT_DEBUGFUNCTION(3).

Default

stderr

Protocols

This functionality affects all supported protocols

Example

int main(void)
{
  CURL *curl = curl_easy_init();
  FILE *filep = fopen("dump", "wb");
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    curl_easy_setopt(curl, CURLOPT_STDERR, filep);

    curl_easy_perform(curl);
  }
}

Availability

Added in curl 7.1

Return Value

Returns CURLE_OK

See Also

CURLOPT_DEBUGFUNCTION(3), CURLOPT_NOPROGRESS(3), CURLOPT_VERBOSE(3)

Referenced By

curl_easy_setopt(3), CURLINFO_RETRY_AFTER(3), CURLOPT_ACCEPTTIMEOUT_MS(3), CURLOPT_ADDRESS_SCOPE(3), CURLOPT_CAPATH(3), CURLOPT_DEBUGDATA(3), CURLOPT_HTTP_CONTENT_DECODING(3), CURLOPT_PATH_AS_IS(3), CURLOPT_PORT(3), CURLOPT_PRIVATE(3), CURLOPT_PROXY_CAPATH(3), CURLOPT_SEEKDATA(3), CURLOPT_SEEKFUNCTION(3), CURLOPT_VERBOSE(3), libcurl-symbols(3).

2024-09-24 libcurl