DragonFly On-Line Manual Pages

CURLOPT_MAXAGE_CONN(3)              libcurl             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 age);

DESCRIPTION
       Pass a long as parameter containing age - the maximum time in seconds
       that you allow an existing connection to have been idle 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 too 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 age, it will instead be closed.

DEFAULT
       Default maximum age is set to 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 7.65.0

RETURN VALUE
       Returns CURLE_OK.

SEE ALSO
       CURLOPT_TIMEOUT(3), CURLOPT_FORBID_REUSE(3),  CURLOPT_FRESH_CONNECT(3),
       CURLOPT_MAXLIFETIME_CONN(3),

ibcurl 8.1.2                    April 26, 2023          CURLOPT_MAXAGE_CONN(3)