]> granicus.if.org Git - curl/commitdiff
curl_global_init_mem.3: Stronger thread safety warning
authorJay Satiro <raysatiro@yahoo.com>
Fri, 14 Aug 2015 03:29:27 +0000 (23:29 -0400)
committerJay Satiro <raysatiro@yahoo.com>
Fri, 14 Aug 2015 03:29:27 +0000 (23:29 -0400)
Bug: http://curl.haxx.se/mail/lib-2015-08/0016.html
Reported-by: Eric Ridge
docs/libcurl/curl_global_init_mem.3

index a21e63d8bd166d8d2b3472f52fadda9b88c0bfa3..0e8c0fa5522d3571145d686a4eaa503d74738813 100644 (file)
@@ -36,12 +36,13 @@ This function works exactly as \fIcurl_global_init(3)\fP with one addition: it
 allows the application to set callbacks to replace the otherwise used internal
 memory functions.
 
-When you use this function, all callback arguments must be set to valid
-function pointers. \fBIf you are using libcurl from multiple threads or with
-the threaded resolver (the default in Windows) the callback replacement
-functions must be thread safe.\fP
+If you are using libcurl from multiple threads or libcurl was built with the
+threaded resolver option then the callback functions must be thread safe. The
+threaded resolver is a common build option to enable (and in some cases the
+default) so we strongly urge you to make your callback functions thread safe.
 
-The prototypes for the given callbacks should match these:
+All callback arguments must be set to valid function pointers. The
+prototypes for the given callbacks must match these:
 .IP "void *malloc_callback(size_t size);"
 To replace malloc()
 .IP "void free_callback(void *ptr);"