aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_global_init.3
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2016-06-29 16:00:46 +0200
committerDaniel Stenberg <daniel@haxx.se>2016-06-29 16:00:46 +0200
commit306192ba55637864e6bf20991cc209c17ff21e55 (patch)
tree54a8b5d6da410403438758cf1840cd2c1e6aa60e /docs/libcurl/curl_global_init.3
parentbbd99a277bf05bd8c1f6fa682e20646f29ac1de4 (diff)
curl_global_init.3: improved formatting of the flags
Diffstat (limited to 'docs/libcurl/curl_global_init.3')
-rw-r--r--docs/libcurl/curl_global_init.320
1 files changed, 7 insertions, 13 deletions
diff --git a/docs/libcurl/curl_global_init.3 b/docs/libcurl/curl_global_init.3
index 01e670793..d2bd79ef3 100644
--- a/docs/libcurl/curl_global_init.3
+++ b/docs/libcurl/curl_global_init.3
@@ -56,14 +56,12 @@ during that time and it could cause a deadlock.
See the description in \fIlibcurl(3)\fP of global environment requirements for
details of how to use this function.
-
.SH FLAGS
-.TP 5
-.B CURL_GLOBAL_ALL
+.IP CURL_GLOBAL_ALL
Initialize everything possible. This sets all known bits except
\fBCURL_GLOBAL_ACK_EINTR\fP.
-.TP
-.B CURL_GLOBAL_SSL
+
+.IP CURL_GLOBAL_SSL
Initialize SSL.
The implication here is that if this bit is not set, the initialization of the
@@ -73,23 +71,19 @@ backend libcurl uses.
Doing TLS based transfers without having the TLS layer initialized may lead to
unexpected behaviors.
-.TP
-.B CURL_GLOBAL_WIN32
+.IP CURL_GLOBAL_WIN32
Initialize the Win32 socket libraries.
The implication here is that if this bit is not set, the initialization of
winsock has to be done by the application or you risk getting undefined
behaviors. This option exists for when the initialization is handled outside
of libcurl so there's no need for libcurl to do it again.
-.TP
-.B CURL_GLOBAL_NOTHING
+.IP CURL_GLOBAL_NOTHING
Initialise nothing extra. This sets no bit.
-.TP
-.B CURL_GLOBAL_DEFAULT
+.IP CURL_GLOBAL_DEFAULT
A sensible default. It will init both SSL and Win32. Right now, this equals
the functionality of the \fBCURL_GLOBAL_ALL\fP mask.
-.TP
-.B CURL_GLOBAL_ACK_EINTR
+.IP CURL_GLOBAL_ACK_EINTR
When this flag is set, curl will acknowledge EINTR condition when connecting
or when waiting for data. Otherwise, curl waits until full timeout
elapses. (Added in 7.30.0)