[GNUnet-SVN] [gnurl] 126/219: CURLMOPT_TIMERFUNCTION.3: warn about the recursive risk [ci skip]

[gnunet]

This is an automated email from the git hooks/post-receive script.

ng0 pushed a commit to branch master
in repository gnurl.

commit 139202bb68dcccd01eab031db5b331db1f999d3b
Author: Daniel Stenberg <address@hidden>
AuthorDate: Fri May 3 15:44:49 2019 +0200

    CURLMOPT_TIMERFUNCTION.3: warn about the recursive risk [ci skip]
    
    Reported-by: Ricardo Gomes
    
    Bug: #3537
    Closes #3836
---
 docs/libcurl/opts/CURLMOPT_TIMERFUNCTION.3 | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/libcurl/opts/CURLMOPT_TIMERFUNCTION.3 
b/docs/libcurl/opts/CURLMOPT_TIMERFUNCTION.3
index d926d811d..344813fe8 100644
--- a/docs/libcurl/opts/CURLMOPT_TIMERFUNCTION.3
+++ b/docs/libcurl/opts/CURLMOPT_TIMERFUNCTION.3
@@ -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
 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
 NULL
 .SH PROTOCOLS

-- 
To stop receiving notification emails like this one, please contact
address@hidden