curl_easy_reset.3 1.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. .\" generated by cd2nroff 0.1 from curl_easy_reset.md
  2. .TH curl_easy_reset 3 "2025-01-17" libcurl
  3. .SH NAME
  4. curl_easy_reset \- reset all options of a libcurl session handle
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. void curl_easy_reset(CURL *handle);
  9. .fi
  10. .SH DESCRIPTION
  11. Re\-initializes all options previously set on a specified CURL handle to the
  12. default values. This puts back the handle to the same state as it was in when
  13. it was just created with \fIcurl_easy_init(3)\fP.
  14. It does not change the following information kept in the handle: live
  15. connections, the Session ID cache, the DNS cache, the cookies, the shares or
  16. the alt\-svc cache.
  17. .SH PROTOCOLS
  18. This functionality affects all supported protocols
  19. .SH EXAMPLE
  20. .nf
  21. int main(void)
  22. {
  23. CURL *curl = curl_easy_init();
  24. if(curl) {
  25. /* ... the handle is used and options are set ... */
  26. curl_easy_reset(curl);
  27. }
  28. }
  29. .fi
  30. .SH AVAILABILITY
  31. Added in curl 7.12.1
  32. .SH RETURN VALUE
  33. Nothing
  34. .SH SEE ALSO
  35. .BR curl_easy_cleanup (3),
  36. .BR curl_easy_duphandle (3),
  37. .BR curl_easy_init (3),
  38. .BR curl_easy_setopt (3)