Revert "Imported Upstream version 7.53.1"
[platform/upstream/curl.git] / docs / libcurl / curl_global_cleanup.3
1 .\" **************************************************************************
2 .\" *                                  _   _ ____  _
3 .\" *  Project                     ___| | | |  _ \| |
4 .\" *                             / __| | | | |_) | |
5 .\" *                            | (__| |_| |  _ <| |___
6 .\" *                             \___|\___/|_| \_\_____|
7 .\" *
8 .\" * Copyright (C) 1998 - 2016, 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_global_cleanup 3 "17 Feb 2006" "libcurl 7.8" "libcurl Manual"
23 .SH NAME
24 curl_global_cleanup - global libcurl cleanup
25 .SH SYNOPSIS
26 .B #include <curl/curl.h>
27 .sp
28 .BI "void curl_global_cleanup(void);"
29 .ad
30 .SH DESCRIPTION
31 This function releases resources acquired by \fIcurl_global_init(3)\fP.
32
33 You should call \fIcurl_global_cleanup(3)\fP once for each call you make to
34 \fIcurl_global_init(3)\fP, after you are done using libcurl.
35
36 \fBThis function is not thread safe.\fP You must not call it when any other
37 thread in the program (i.e. a thread sharing the same memory) is running.
38 This doesn't just mean no other thread that is using libcurl.  Because
39 \fIcurl_global_cleanup(3)\fP calls functions of other libraries that are
40 similarly thread unsafe, it could conflict with any other thread that uses
41 these other libraries.
42
43 See the description in \fIlibcurl(3)\fP of global environment requirements for
44 details of how to use this function.
45
46 .SH "SEE ALSO"
47 .BR curl_global_init "(3), "
48 .BR libcurl "(3), "
49