aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_init.3
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2006-01-15 23:55:53 +0000
committerDaniel Stenberg <daniel@haxx.se>2006-01-15 23:55:53 +0000
commit4c35a40858db71daa0f6be4111c620fb201f245a (patch)
tree1107ae836fbf51f066d45363103b278de81c8636 /docs/libcurl/curl_easy_init.3
parent802b2aaf6a5e640b868dc47b53df13a7d931cc5e (diff)
Bryan Henderson turned the 'initialized' variable for curl_global_init()
into a counter, and thus you can now do multiple curl_global_init() and you are then supposed to do the same amount of calls to curl_global_cleanup(). Bryan also updated the docs accordingly.
Diffstat (limited to 'docs/libcurl/curl_easy_init.3')
-rw-r--r--docs/libcurl/curl_easy_init.315
1 files changed, 10 insertions, 5 deletions
diff --git a/docs/libcurl/curl_easy_init.3 b/docs/libcurl/curl_easy_init.3
index a9fbe792a..083633627 100644
--- a/docs/libcurl/curl_easy_init.3
+++ b/docs/libcurl/curl_easy_init.3
@@ -14,12 +14,17 @@ handle that you must use as input to other easy-functions. curl_easy_init
initializes curl and this call \fBMUST\fP have a corresponding call to
\fIcurl_easy_cleanup(3)\fP when the operation is complete.
-If you did not already call \fIcurl_global_init(3)\fP, it will be done
-automatically with a default setup when you call \fIcurl_easy_init(3)\fP.
+If you did not already call \fIcurl_global_init(3)\fP,
+\fIcurl_easy_init(3)\fP does it automatically.
This may be lethal in multi-threaded cases, since \fIcurl_global_init(3)\fP is
-not thread-safe and must not be called more than once (or from more than one
-thread). You are strongly adviced to not rely on this automatic behaviour, but
-call \fIcurl_global_init(3)\fP yourself properly.
+not thread-safe, and it may result in resource problems because there is
+no corresponding cleanup.
+
+You are strongly advised to not allow this automatic behaviour, by
+calling \fIcurl_global_init(3)\fP yourself properly.
+See the description in \fBlibcurl\fP(3) of global environment
+requirements for details of how to use this function.
+
.SH RETURN VALUE
If this function returns NULL, something went wrong and you cannot use the
other curl functions.