Imported Upstream version 7.59.0
[platform/upstream/curl.git] / docs / libcurl / curl_easy_reset.3
1 .\" **************************************************************************
2 .\" *                                  _   _ ____  _
3 .\" *  Project                     ___| | | |  _ \| |
4 .\" *                             / __| | | | |_) | |
5 .\" *                            | (__| |_| |  _ <| |___
6 .\" *                             \___|\___/|_| \_\_____|
7 .\" *
8 .\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
9 .\" *
10 .\" * This software is licensed as described in the file COPYING, which
11 .\" * you should have received as part of this distribution. The terms
12 .\" * are also available at https://curl.haxx.se/docs/copyright.html.
13 .\" *
14 .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 .\" * copies of the Software, and permit persons to whom the Software is
16 .\" * furnished to do so, under the terms of the COPYING file.
17 .\" *
18 .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 .\" * KIND, either express or implied.
20 .\" *
21 .\" **************************************************************************
22 .TH curl_easy_reset 3 "February 03, 2016" "libcurl 7.59.0" "libcurl Manual"
23
24 .SH NAME
25 curl_easy_reset - reset all options of a libcurl session handle
26 .SH SYNOPSIS
27 .B #include <curl/curl.h>
28
29 .BI "void curl_easy_reset(CURL *"handle ");"
30
31 .SH DESCRIPTION
32 Re-initializes all options previously set on a specified CURL handle to the
33 default values. This puts back the handle to the same state as it was in when
34 it was just created with \fIcurl_easy_init(3)\fP.
35
36 It does not change the following information kept in the handle: live
37 connections, the Session ID cache, the DNS cache, the cookies and shares.
38 .SH AVAILABILITY
39 This function was added in libcurl 7.12.1
40 .SH RETURN VALUE
41 Nothing
42 .SH "SEE ALSO"
43 .BR curl_easy_init "(3)," curl_easy_cleanup "(3)," curl_easy_setopt "(3),"
44 .BR curl_easy_duphandle "(3)"
45