NAME

       CURLOPT_MAXAGE_CONN - max idle time allowed for reusing a connection

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXAGE_CONN, long maxage);

DESCRIPTION

       Pass a long as parameter containing maxage - the maximum time in seconds that you allow an
       existing connection to have to be considered for reuse for this request.

       The "connection cache" that holds previously used connections. When a new request is to be
       done,  it  will consider any connection that matches for reuse. The CURLOPT_MAXAGE_CONN(3)
       limit prevents libcurl from trying very old connections for reuse, since  old  connections
       have  a  high risk of not working and thus trying them is a performance loss and sometimes
       service loss due to the difficulties to figure out the situation. If a connection is found
       in the cache that is older than this set maxage, it will instead be closed.

DEFAULT

       Default maxage is 118 seconds.

PROTOCOLS

       All

EXAMPLE

       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

         /* only allow 30 seconds idle time */
         curl_easy_setopt(curl, CURLOPT_MAXAGE_CONN, 30L);

         curl_easy_perform(curl);
       }

AVAILABILITY

       Added in libcurl 7.65.0

RETURN VALUE

       Returns CURLE_OK.

SEE ALSO

       CURLOPT_TIMEOUT(3), CURLOPT_FORBID_REUSE(3), CURLOPT_FRESH_CONNECT(3),