CURLOPT_MAXAGE_CONN(3)     curl_easy_setopt options     CURLOPT_MAXAGE_CONN(3)

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 _MAXAGE_CONN&section=3">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, "https://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),

libcurl 7.77.0                 November 4, 2020         CURLOPT_MAXAGE_CONN(3)