CURLOPT_STDERR.3: does not work with libcurl as a win32 DLL

This is the exact same limitation already documented for
CURLOPT_WRITEDATA but should be clarified here. It also has a different
work-around.

Reported-by: Stephane Pellegrino
Bug: https://github.com/curl/curl/issues/8102
Closes #8103
This commit is contained in:
Daniel Stenberg 2021-12-06 15:05:16 +01:00
parent 2b3dd01b77
commit 1a4c14cbac
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -33,6 +33,10 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STDERR, FILE *stream);
Pass a FILE * as parameter. Tell libcurl to use this \fIstream\fP instead of
stderr when showing the progress meter and displaying \fICURLOPT_VERBOSE(3)\fP
data.
If you are using libcurl as a win32 DLL, this option will cause an exception
and crash in the library since it cannot access a FILE * passed on from the
application. A work-around is to instead use \fICURLOPT_DEBUGFUNCTION(3)\fP.
.SH DEFAULT
stderr
.SH PROTOCOLS
@ -54,3 +58,4 @@ Always
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_VERBOSE "(3), " CURLOPT_NOPROGRESS "(3), "
.BR CURLOPT_DEBUGFUNCTION "(3) "