DragonFly On-Line Manual Pages

CURLOPT_MAXLIFETIME_CONN(3)         libcurl        CURLOPT_MAXLIFETIME_CONN(3)

NAME
       CURLOPT_MAXLIFETIME_CONN - max lifetime (since creation) allowed for
       reusing a connection

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXLIFETIME_CONN,
                                 long maxlifetime);

DESCRIPTION
       Pass a long as parameter containing maxlifetime - the maximum time in
       seconds, since the creation of the connection, that you allow an
       existing connection to have to be considered for reuse for this
       request.

       libcurl features a 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_MAXLIFETIME_CONN(3)
       limit prevents libcurl from trying too old connections for reuse. This
       can be used for client-side load balancing. If a connection is found in
       the cache that is older than this set maxlifetime, it will instead be
       closed once any in-progress transfers complete.

       If set to 0, this behavior is disabled: all connections are eligible
       for reuse.

DEFAULT
       Default maxlifetime is 0 seconds (i.e., disabled).

PROTOCOLS
       All

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

         /* only allow each connection to be reused for 30 seconds */
         curl_easy_setopt(curl, CURLOPT_MAXLIFETIME_CONN, 30L);

         curl_easy_perform(curl);
       }

AVAILABILITY
       Added in 7.80.0

RETURN VALUE
       Returns CURLE_OK.

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

ibcurl 8.1.2                    April 26, 2023     CURLOPT_MAXLIFETIME_CONN(3)