From: Daniel Stenberg <daniel@haxx.se>
Date: Mon, 6 Dec 2021 14:05:16 +0000 (+0100)
Subject: CURLOPT_STDERR.3: does not work with libcurl as a win32 DLL
X-Git-Tag: curl-7_81_0~99
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=1a4c14cbac9a29e7a943846cfa59cb404556961e;p=thirdparty%2Fcurl.git

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
---

diff --git a/docs/libcurl/opts/CURLOPT_STDERR.3 b/docs/libcurl/opts/CURLOPT_STDERR.3
index c878527644..ad7ed9bb42 100644
--- a/docs/libcurl/opts/CURLOPT_STDERR.3
+++ b/docs/libcurl/opts/CURLOPT_STDERR.3
@@ -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) "