Manpages - CURLOPT_MAXAGE_CONN.3

CURLOPT_MAXAGE_CONN - max idle time allowed for reusing a connection

#include <curl/curl.h>

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

Pass a long as parameter containing maxage - 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 maxage, it will instead be closed.

Default maxage is 118 seconds.

All

  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);
  }

Added in 7.65.0

Returns CURLE_OK.

*CURLOPT_TIMEOUT*(3), *CURLOPT_FORBID_REUSE*(3), *CURLOPT_FRESH_CONNECT*(3), *CURLOPT_MAXLIFETIME_CONN*(3),