From 542df800ab422380e5af84102509b9aa9d239286 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 12 Mar 2001 14:54:00 +0000 Subject: Added four new options that come with the new persitant support: CURLOPT_MAXCONNECTS, CURLOPT_CLOSEPOLICY, CURLOPT_FRESH_CONNECT and CURLOPT_FORBID_REUSE --- docs/curl_easy_setopt.3 | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/curl_easy_setopt.3 b/docs/curl_easy_setopt.3 index ef91d2d3d..564b7faa0 100644 --- a/docs/curl_easy_setopt.3 +++ b/docs/curl_easy_setopt.3 @@ -426,6 +426,35 @@ Pass a long. The set number will be the redirection limit. If that many redirections have been followed, the next redirect will cause an error. This option only makes sense if the CURLOPT_FOLLOWLOCATION is used at the same time. (Added in 7.5) +.TP +.B CURLOPT_MAXCONNECTS +Pass a long. The set number will be the persistant connection cache size. The +set amount will be the maximum amount of simultaneous connections that libcurl +may cache between file transfers. 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. Note: if you have already performed transfers +with this curl handle, setting a smaller MAXCONNECTS than before may cause +open connections to unnecessarily get closed. (Added in 7.7) +.TP +.B CURLOPT_CLOSEPOLICY +Pass a long. This must be one of the CURLCLOSEPOLICY_* defines. This is still +not supported as of this writing. (Added in 7.7) +.TP +.B CURLOPT_FRESH_CONNECT +Pass a long. Set to non-zero to make the next transfer use a new connection by +force. If the connection cache is full before this connection, one of the +existinf connections will be closed as according to the set policy. This +option should be used with caution and only if you understand what it +does. Set to 0 to have libcurl attempt re-use of an existing connection. +(Added in 7.7) +.TP +.B CURLOPT_FORBID_REUSE +Pass a long. Set to non-zero to make the next transfer explicitly close the +connection when done. Normally, libcurl keep all connections alive when done +with one transfer in case there comes a succeeding one that can re-use them. +This option should be used with caution and only if you understand what it +does. Set to 0 to have libcurl keep the connection open for possibly later +re-use. (Added in 7.7) .PP .SH RETURN VALUE 0 means the option was set properly, non-zero means an error as -- cgit v1.2.3