summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2021-12-06 15:05:16 +0100
committerDaniel Stenberg <daniel@haxx.se>2021-12-06 16:43:28 +0100
commit1a4c14cbac9a29e7a943846cfa59cb404556961e (patch)
tree685099120d00f35f881a7ddf033395c4796f1898
parent2b3dd01b779e4eff623a735792a915cde914b74a (diff)
downloadcurl-1a4c14cbac9a29e7a943846cfa59cb404556961e.tar.gz
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
-rw-r--r--docs/libcurl/opts/CURLOPT_STDERR.35
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/libcurl/opts/CURLOPT_STDERR.3 b/docs/libcurl/opts/CURLOPT_STDERR.3
index c87852764..ad7ed9bb4 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) "