Added CURLMOPT_MAXCONNECTS which is a curl_multi_setopt() option for setting

                             \___|\___/|_| \_\_____|

                                  Changelog

Daniel S (30 May 2007)

- Added CURLMOPT_MAXCONNECTS which is a curl_multi_setopt() option for setting

  the maximum size of the connection cache maximum size of the multi handle.

Daniel S (27 May 2007)

- When working with a problem Stefan Becker had, I found an off-by-one buffer

  overwrite in Curl_select(). While fixing it, I also improved its performance

 o CURLOPT_HTTP200ALIASES matched transfers assume HTTP 1.0 compliance

 o more than one test harness can run at the same time without conflict

 o SFTP now supports quote commands before a transfer

 o CURLMOPT_MAXCONNECTS added to curl_multi_setopt()

This release includes the following bugfixes:

.IP CURLOPT_MAXCONNECTS

Pass a long. The set number will be the persistent connection cache size. The

set amount will be the maximum amount of simultaneously open connections that

libcurl may cache. Default is 5, and there isn't much point in changing this

value unless you are perfectly aware of how this work and changes libcurl's

behaviour. This concerns connection using any of the protocols that support

persistent connections.

libcurl may cache in this easy handle. Default is 5, and there isn't much

point in changing this value unless you are perfectly aware of how this work

and changes libcurl's behaviour. This concerns connection using any of the

protocols that support persistent connections.

When reaching the maximum limit, curl closes the oldest one in the cache to

prevent the number of open connections to increase.

If you already have performed transfers with this curl handle, setting a

smaller MAXCONNECTS than before may cause open connections to get closed

unnecessarily.

Note that if you add this easy handle to a multi handle, this setting is not

being acknowledged, but you must instead use \fIcurl_multi_setopt(3)\fP and

the \fICURLMOPT_MAXCONNECTS\fP option.

.IP CURLOPT_CLOSEPOLICY

(Obsolete) This option does nothing.

.IP CURLOPT_FRESH_CONNECT

\fBcurl_multi_timer_callback\fP's third argument, the userp pointer.  This is

not used by libcurl but only passed-thru as-is. Set the callback pointer with

\fICURLMOPT_TIMERFUNCTION\fP. (Added in 7.16.0)

.IP CURLMOPT_MAXCONNECTS

Pass a long. The set number will be used as the maximum amount of

simultaneously open connections that libcurl may cache. Default is 10, and

libcurl will enlarge the size for each added easy handle to make it fit 4

times the number of added easy handles.

By setting this option, you can prevent the cache size to grow beyond the

limit set by you.

When the cache is full, curl closes the oldest one in the cache to prevent the

number of open connections to increase.

This option is for the multi handle's use only, when using the easy interface

you should instead use the \fICURLOPT_MAXCONNECTS\fP option.

(Added in 7.16.3)

.SH RETURNS

The standard CURLMcode for multi interface error codes. Note that it returns a

CURLM_UNKNOWN_OPTION if you try setting an option that this version of libcurl

  /* This is the argument passed to the timer callback */

  CINIT(TIMERDATA, OBJECTPOINT, 5),

  /* maximum number of entries in the connection cache */

  CINIT(MAXCONNECTS, LONG, 6),

  CURLMOPT_LASTENTRY /* the last unused */

} CURLMoption;