---
name: "CURLOPT_FRESH_CONNECT"
section: "3"
platform: "linux"
package: "curl"
version: "8.23.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/CURLOPT_FRESH_CONNECT"
---

# CURLOPT\_FRESH\_CONNECT(3)

force a new connection to be used

## 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)](/CURLOPT_FORBID_REUSE/3.md)* 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) {
    CURLcode result;
    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 */
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}
```

## AVAILABILITY

Added in curl 7.7

## RETURN VALUE

*[curl\_easy\_setopt(3)](/curl_easy_setopt/3.md)* returns a CURLcode indicating success or error.

CURLE\_OK (0) means everything was OK, non-zero means an error occurred, see *[libcurl-errors(3)](/libcurl-errors/3.md)*.

## SEE ALSO

[**CURLMOPT\_NETWORK\_CHANGED**(3)](/CURLMOPT_NETWORK_CHANGED/3.md), [**CURLOPT\_FORBID\_REUSE**(3)](/CURLOPT_FORBID_REUSE/3.md), [**CURLOPT\_MAXAGE\_CONN**(3)](/CURLOPT_MAXAGE_CONN/3.md), [**CURLOPT\_MAXLIFETIME\_CONN**(3)](/CURLOPT_MAXLIFETIME_CONN/3.md)