CURLOPT_MAXLIFETIME_CONN(3) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

CURLOPT_MAXLIFETIME_CONN(3)

curl_easy_setopt options                           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 exist‐
       ing connection to have to be considered for reuse for this request.

       libcurl features a connection cache that holds previously used  connec‐
       tions.   When a new request is to be done, it will consider any connec‐
       tion that matches for reuse. The CURLOPT_MAXLIFETIME_CONN(3) limit pre‐
       vents  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),



libcurl 7.86.0                   May 17, 2022
                                                   CURLOPT_MAXLIFETIME_CONN(3)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3