CURLMOPT_TIMERFUNCTION.3: warn about the recursive risk [ci skip]

Reported-by: Ricardo Gomes

Bug: #3537
Closes #3836
This commit is contained in:
Daniel Stenberg 2019-05-03 15:44:49 +02:00
parent 28f38da506
commit 139202bb68
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -54,6 +54,11 @@ The \fBuserp\fP pointer is set with \fICURLMOPT_TIMERDATA(3)\fP.
The timer callback should return 0 on success, and -1 on error. This callback The timer callback should return 0 on success, and -1 on error. This callback
can be used instead of, or in addition to, \fIcurl_multi_timeout(3)\fP. can be used instead of, or in addition to, \fIcurl_multi_timeout(3)\fP.
\fBWARNING:\fP even if it feels tempting, avoid calling libcurl directly from
within the callback itself when the \fBtimeout_ms\fP value is zero, since it
risks triggering an unpleasant recursive behavior that immediately calls
another call to the callback with a zero timeout...
.SH DEFAULT .SH DEFAULT
NULL NULL
.SH PROTOCOLS .SH PROTOCOLS