NAME

       CURLOPT_FRESH_CONNECT - force a new connection to be used

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FRESH_CONNECT, long fresh);

DESCRIPTION

       Pass  a  long. Set to 1 to make the next transfer use a new (fresh) connection by force instead of trying
       to reuse an existing one. This option should be used with caution and only if you understand what it does
       as it may impact performance negatively.

       Related  functionality  is CURLOPT_FORBID_REUSE(3) which makes sure the connection is closed after use so
       that it cannot be reused.

       Set fresh to 0 to have libcurl attempt reusing an existing connection (default behavior).

DEFAULT

       0

PROTOCOLS

       This functionality affects all supported protocols

EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
           curl_easy_setopt(curl, CURLOPT_FRESH_CONNECT, 1L);
           /* this transfer must use a new connection, not reuse an existing */
           curl_easy_perform(curl);
           curl_easy_cleanup(curl);
         }
       }

AVAILABILITY

       Added in curl 7.7

RETURN VALUE

       Returns CURLE_OK

SEE ALSO

       CURLOPT_FORBID_REUSE(3), CURLOPT_MAXAGE_CONN(3), CURLOPT_MAXLIFETIME_CONN(3)