DragonFly On-Line Manual Pages

Search: Section:  

CURLOPT_FRESH_CONNECT(3)            libcurl           CURLOPT_FRESH_CONNECT(3)


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 re-use an existing one.  This
       option should be used with caution and only if you understand what it
       does as it may seriously impact performance.

       Related functionality is CURLOPT_FORBID_REUSE(3) which makes sure the
       connection is closed after use so that it will not be re-used.

       Set fresh to 0 to have libcurl attempt re-using an existing connection
       (default behavior).


DEFAULT

       0


PROTOCOLS

       Most


EXAMPLE

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


AVAILABILITY

       Always


RETURN VALUE

       Returns CURLE_OK


SEE ALSO

       CURLOPT_FORBID_REUSE(3),

ibcurl 8.1.2                    April 26, 2023        CURLOPT_FRESH_CONNECT(3)

Search: Section: