Sortix cross-volatile manual
This manual documents Sortix cross-volatile. You can instead view this document in the latest official manual.
CURLOPT_FRESH_CONNECT(3) | Library Functions Manual | CURLOPT_FRESH_CONNECT(3) |
NAME
CURLOPT_FRESH_CONNECT - force a new connection to be usedSYNOPSIS
#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.DEFAULT
0PROTOCOLS
This functionality affects all supported protocolsEXAMPLE
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.7RETURN VALUE
Returns CURLE_OKSEE ALSO
CURLOPT_FORBID_REUSE(3), CURLOPT_MAXAGE_CONN(3), CURLOPT_MAXLIFETIME_CONN(3)2024-11-23 | libcurl |