curl/docs/libcurl/opts/CURLOPT_STDERR.md
Daniel Stenberg e3fe020089
docs/libcurl: generate PROTOCOLS from meta-data
Remove the PROTOCOLS section from the source files completely and
instead generate them based on the header data in the curldown files.

It also generates TLS backend information for options marked for TLS as
protocol.

Closes #13175
2024-03-23 18:13:03 +01:00

64 lines
1.1 KiB
Markdown

---
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Title: CURLOPT_STDERR
Section: 3
Source: libcurl
See-also:
- CURLOPT_DEBUGFUNCTION (3)
- CURLOPT_NOPROGRESS (3)
- CURLOPT_VERBOSE (3)
Protocol:
- All
---
# NAME
CURLOPT_STDERR - redirect stderr to another stream
# SYNOPSIS
~~~c
#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
# EXAMPLE
~~~c
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
Always
# RETURN VALUE
Returns CURLE_OK