curl_easy_reset(3)

curl_easy_reset3

Reset all options of a libcurl session handle

Usage

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

Overview

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 just created with curl_easy_init(3).

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.

Examples

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

Return value

Nothing

Releases

135 releases since Mac OS X 10.4; the text changed 18 times.

  1. 10.4–10.4.11
  2. 10.5–10.6.2
  3. 10.6.3–10.6.8
  4. 10.7–10.7.5
  5. 10.8–10.10.4
  6. 10.10.5–10.11.6
  7. 10.12–10.12.5
  8. 10.12.6–10.14.6
  9. 10.15–11.5
  10. 12.0.1–12.2
  11. 12.3–12.5
  12. 13.0
  13. 13.1
  14. 13.2
  15. 13.3
  16. 13.4
  17. 13.5–14.1
  18. 14.2–14.4
  19. 14.5–26.5

Availability

This function was added in libcurl 7.12.1

From curl 166.0.0.0.1 in macOS 26.5. Parsed by carta from the page's man source.