1curl_easy_cleanup(3)            libcurl Manual            curl_easy_cleanup(3)
2
3
4

NAME

6       curl_easy_cleanup - End a libcurl easy session
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       void curl_easy_cleanup(CURL *handle);
12
13

DESCRIPTION

15       This function must be the last function to call for an easy session. It
16       is the opposite of the curl_easy_init(3) function and  must  be  called
17       with the same handle as input that the curl_easy_init call returned.
18
19       This  will  effectively  close all connections this handle has used and
20       possibly has kept open until now.  Don't  call  this  function  if  you
21       intend to transfer more files.
22
23       Occasionally  you  may  get  your  progress callback or header callback
24       called from within curl_easy_cleanup(3) (if previously set for the han‐
25       dle  using  curl_easy_setopt(3)).  Like if libcurl decides to shut down
26       the connection and the protocol is of  a  kind  that  requires  a  com‐
27       mand/response  sequence  before  disconnect. Examples of such protocols
28       are FTP, POP3 and IMAP.
29
30       Any uses of the handle after this function has  been  called  and  have
31       returned,  are illegal. This kills the handle and all memory associated
32       with it!
33
34       With libcurl versions prior to 7.17.: when you've called this, you  can
35       safely remove all the strings you've previously told libcurl to use, as
36       it won't use them anymore now.
37

RETURN VALUE

39       None
40

SEE ALSO

42       curl_easy_init(3),
43
44
45
46
47libcurl 7.17.0                    22 aug 2007             curl_easy_cleanup(3)
Impressum