curl_global_cleanup.3 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
  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. You should call \fIcurl_global_cleanup(3)\fP once for each call you make to
  33. \fIcurl_global_init(3)\fP, after you are done using libcurl.
  34. \fBThis function is not thread safe.\fP You must not call it when any other
  35. thread in the program (i.e. a thread sharing the same memory) is running.
  36. This doesn't just mean no other thread that is using libcurl. Because
  37. \fIcurl_global_cleanup(3)\fP calls functions of other libraries that are
  38. similarly thread unsafe, it could conflict with any other thread that uses
  39. these other libraries.
  40. See the description in \fIlibcurl(3)\fP of global environment requirements for
  41. details of how to use this function.
  42. .SH CAUTION
  43. \fIcurl_global_cleanup(3)\fP does not block waiting for any libcurl-created
  44. threads to terminate (such as threads used for name resolving). If a module
  45. containing libcurl is dynamically unloaded while libcurl-created threads are
  46. still running then your program may crash or other corruption may occur. We
  47. recommend you do not run libcurl from any module that may be unloaded
  48. dynamically. This behavior may be addressed in the future.
  49. .SH "SEE ALSO"
  50. .BR curl_global_init "(3), "
  51. .BR libcurl "(3), "
  52. .BR libcurl-thread "(3), "