generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

clarified what CURLOPT_MAXCONNECTS actually do

Browse Source
This commit is contained in:
Daniel Stenberg 2002-09-13 12:37:14 +00:00
parent 511ce35631
commit 22cf05519a
1 changed files with 13 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/libcurl/curl_easy_setopt.3
View File

@ -2,7 +2,7 @@
.\" nroff -man [file] .\" nroff -man [file]
.\" $Id$ .\" $Id$
.\" .\"
.TH curl_easy_setopt 3 "20 Aug 2002" "libcurl 7.9.9" "libcurl Manual" .TH curl_easy_setopt 3 "13 Sep 2002" "libcurl 7.10" "libcurl Manual"
.SH NAME .SH NAME
curl_easy_setopt - Set curl easy-session options curl_easy_setopt - Set curl easy-session options
.SH SYNOPSIS .SH SYNOPSIS
@ -572,11 +572,16 @@ redirections have been followed, the next redirect will cause an error
\fICURLOPT_FOLLOWLOCATION\fP is used at the same time. (Added in 7.5) \fICURLOPT_FOLLOWLOCATION\fP is used at the same time. (Added in 7.5)
.TP .TP
.B CURLOPT_MAXCONNECTS .B CURLOPT_MAXCONNECTS
Pass a long. The set number will be the persistant connection cache size. The Pass a long. The set number will be the persistent connection cache size. The
set amount will be the maximum amount of simultaneous connections that libcurl set amount will be the maximum amount of simultaneously open connections that
may cache between file transfers. Default is 5, and there isn't much point in libcurl may cache. Default is 5, and there isn't much point in changing this
changing this value unless you are perfectly aware of how this work and value unless you are perfectly aware of how this work and changes libcurl's
changes libcurl's behaviour. behaviour. This concerns connection using any of the protocols that support
persistent connections.
When reaching the maximum limit, curl uses the \fICURLOPT_CLOSEPOLICY\fP to
figure out which of the existing connections to close to prevent the number of
open connections to increase.
\fBNOTE:\fP if you already have performed transfers with this curl handle, \fBNOTE:\fP if you already have performed transfers with this curl handle,
setting a smaller MAXCONNECTS than before may cause open connections to get setting a smaller MAXCONNECTS than before may cause open connections to get
@ -710,14 +715,14 @@ passed to the callback.
Pass a long specifying your prefered size for the receive buffer in libcurl. Pass a long specifying your prefered size for the receive buffer in libcurl.
The main point of this would be that the write callback gets called more often The main point of this would be that the write callback gets called more often
and with smaller chunks. This is just treated as a request, not an order. You and with smaller chunks. This is just treated as a request, not an order. You
cannot be guaranteed to actually get the given size. (Added in 7.9.9) cannot be guaranteed to actually get the given size. (Added in 7.10)
.TP .TP
.B CURLOPT_NOSIGNAL .B CURLOPT_NOSIGNAL
Pass a long. If it is non-zero, libcurl will not use any functions that Pass a long. If it is non-zero, libcurl will not use any functions that
install signal handlers or any functions that cause signals to be sent to the install signal handlers or any functions that cause signals to be sent to the
process. This option is mainly here to allow multi-threaded unix applications process. This option is mainly here to allow multi-threaded unix applications
to still set/use all timeout options etc, without risking getting signals. to still set/use all timeout options etc, without risking getting signals.
(Added in 7.9.9) (Added in 7.10)
.PP .PP
.SH RETURN VALUE .SH RETURN VALUE
CURLE_OK (zero) means that the option was set properly, non-zero means an CURLE_OK (zero) means that the option was set properly, non-zero means an