curl/docs/libcurl/curl_easy_reset.md
Daniel Stenberg e3fe020089
docs/libcurl: generate PROTOCOLS from meta-data
Remove the PROTOCOLS section from the source files completely and
instead generate them based on the header data in the curldown files.

It also generates TLS backend information for options marked for TLS as
protocol.

Closes #13175
2024-03-23 18:13:03 +01:00

1.0 KiB

c SPDX-License-Identifier Title Section Source See-also Protocol
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl curl_easy_reset 3 libcurl
curl_easy_cleanup (3)
curl_easy_duphandle (3)
curl_easy_init (3)
curl_easy_setopt (3)
All

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 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.

EXAMPLE

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {

    /* ... the handle is used and options are set ... */
    curl_easy_reset(curl);
  }
}

AVAILABILITY

This function was added in libcurl 7.12.1

RETURN VALUE

Nothing