CURLOPT_FRESH_CONNECT(3) Library Functions Manual CURLOPT_FRESH_CONNECT(3) NAME CURLOPT_FRESH_CONNECT - force a new connection to be used SYNOPSIS #include 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 All 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 Always RETURN VALUE Returns CURLE_OK SEE ALSO CURLOPT_FORBID_REUSE(3), CURLOPT_MAXAGE_CONN(3), CURLOPT_MAXLIFETIME_CONN(3) libcurl April 02 2024 CURLOPT_FRESH_CONNECT(3)