moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2025-03-11 07:39:50 -04:00
Code Issues Releases Wiki Activity

add multi-thread details for GnuTLS

Browse Source
This commit is contained in:
Daniel Stenberg 2005-05-09 13:13:38 +00:00
parent a295408e09
commit e816bd259f
1 changed files with 18 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/libcurl/libcurl-tutorial.3
View File

@ -21,7 +21,7 @@
.\" * $Id$ .\" * $Id$
.\" ************************************************************************** .\" **************************************************************************
.\" .\"
.TH libcurl-tutorial 3 "25 Jan 2005" "libcurl" "libcurl programming" .TH libcurl-tutorial 3 "9 May 2005" "libcurl" "libcurl programming"
.SH NAME .SH NAME
libcurl-tutorial \- libcurl programming tutorial libcurl-tutorial \- libcurl programming tutorial
.SH "Objective" .SH "Objective"
@ -246,16 +246,26 @@ you intend to make another transfer. libcurl will then attempt to re-use the
previous previous
.SH "Multi-threading Issues" .SH "Multi-threading Issues"
libcurl is completely thread safe, except for two issues: signals and alarm The first basic rule is that you must \fBnever\fP share a libcurl handle (be
handlers. Signals are needed for a SIGPIPE handler, and the alarm() call is it easy or multi or whatever) between multiple threads. Only use one handle in
used to deal with timeouts (during DNS lookup). one thread at a time.
libcurl is completely thread safe, except for two issues: signals and SSL/TLS
handlers. Signals are used timeouting name resolves (during DNS lookup) - when
built without c-ares support and not on Windows..
If you are accessing HTTPS or FTPS URLs in a multi-threaded manner, you are If you are accessing HTTPS or FTPS URLs in a multi-threaded manner, you are
then of course using OpenSSL multi-threaded and it has itself a few then of course using OpenSSL/GnuTLS multi-threaded and those libs have their
requirements on this. Basically, you need to provide one or two functions to own requirements on this issue. Basically, you need to provide one or two
allow it to function properly. For all details, see this: functions to allow it to function properly. For all details, see this:
http://www.openssl.org/docs/crypto/threads.html#DESCRIPTION OpenSSL
http://www.openssl.org/docs/crypto/threads.html#DESCRIPTION
GnuTLS
http://www.gnu.org/software/gnutls/manual/html_node/Multi_002dthreaded-applications.html
When using multiple threads you should set the CURLOPT_NOSIGNAL option to When using multiple threads you should set the CURLOPT_NOSIGNAL option to
TRUE for all handles. Everything will work fine except that timeouts are not TRUE for all handles. Everything will work fine except that timeouts are not