---
name: "curl_easy_reset"
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/curl_easy_reset"
---

# curl\_easy\_reset(3)

reset all options of a libcurl session handle

## NAME

curl\_easy\_reset - reset all options of a libcurl session handle

## SYNOPSIS

```
#include <curl/curl.h>
void curl_easy_reset(CURL *handle);
```

## DESCRIPTION

Re-initializes all options previously set on a specified curl handle to the default values. This puts back the handle to the same state as it was in when it was created with *[curl\_easy\_init(3)](/curl_easy_init/3.md)*.

It does not change the following information kept in the handle: live connections, the Session ID cache, the DNS cache, the cookies, the shares or the alt-svc cache.

## PROTOCOLS

This functionality affects all supported protocols

## EXAMPLE

```
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    /* ... the handle is used and options are set ... */
    curl_easy_reset(curl);
  }
}
```

## AVAILABILITY

Added in curl 7.12.1

## RETURN VALUE

Nothing

## SEE ALSO

[**curl\_easy\_cleanup**(3)](/curl_easy_cleanup/3.md), [**curl\_easy\_duphandle**(3)](/curl_easy_duphandle/3.md), [**curl\_easy\_init**(3)](/curl_easy_init/3.md), [**curl\_easy\_setopt**(3)](/curl_easy_setopt/3.md)