A command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features
Go to file
Aki a2bcec0ee0
openssl: fix the data race when sharing an SSL session between threads
The SSL_Session object is mutated during connection inside openssl,
and it might not be thread-safe. Besides, according to documentation
of openssl:

```
SSL_SESSION objects keep internal link information about the session
cache list, when being inserted into one SSL_CTX object's session
cache. One SSL_SESSION object, regardless of its reference count,
must therefore only be used with one SSL_CTX object (and the SSL
objects created from this SSL_CTX object).
```
If I understand correctly, it is not safe to share it even in a
single thread.

Instead, serialize the SSL_SESSION before adding it to the cache,
and deserialize it after retrieving it from the cache, so that no
concurrent write to the same object is infeasible.

Also
 - add a ci test for thread sanitizer
 - add a test for sharing ssl sessions concurrently
 - avoid redefining memory functions when not building libcurl, but
   including the soruce in libtest
 - increase the concurrent connections limit in sws

Notice that there are fix for a global data race for openssl which
is not yet release. The fix is cherry pick for the ci test with
thread sanitizer.
d8def79838

Closes #14751
2024-09-02 23:35:44 +02:00
.circleci GHA/macos: improve, fix gcc/llvm, add new test matrix 2024-07-19 12:45:18 +02:00
.github openssl: fix the data race when sharing an SSL session between threads 2024-09-02 23:35:44 +02:00
CMake build: add poll() detection for cross-builds 2024-08-30 17:14:33 +02:00
docs printf: fix mingw-w64 format checks 2024-09-02 21:03:01 +02:00
include printf: fix mingw-w64 format checks 2024-09-02 21:03:01 +02:00
lib openssl: fix the data race when sharing an SSL session between threads 2024-09-02 23:35:44 +02:00
LICENSES copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
m4 lib: remove use of RANDOM_FILE 2024-09-02 18:42:32 +02:00
packages tests: delete libhostname.so and chkhostname 2024-08-27 23:40:48 +02:00
plan9 copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
projects misc: general C style cleanups 2024-08-22 23:43:45 +02:00
scripts managen: in man output, remove the leading space from examples 2024-08-30 10:09:48 +02:00
src configure: remove USE_EXPLICIT_LIB_DEPS 2024-08-28 13:45:01 +02:00
tests openssl: fix the data race when sharing an SSL session between threads 2024-09-02 23:35:44 +02:00
winbuild tidy-up: OS names 2024-08-04 19:17:45 +02:00
.azure-pipelines.yml CI/azure: disable parallel tests, allow IDN tests 2024-08-19 14:09:14 +02:00
.dcignore copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
.dir-locals.el copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
.git-blame-ignore-revs copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
.gitattributes winbuild: MS-DOS batch tidy-ups 2024-07-02 19:26:15 +02:00
.gitignore CHANGES: rename to CHANGES.md, no longer generated 2024-08-01 13:37:12 +02:00
.mailmap mailmap: Aki Sakurai 2024-08-30 10:28:34 +02:00
acinclude.m4 configure: delete unused CURL_DEFINE_UNQUOTED function 2024-08-26 11:01:14 +02:00
appveyor.sh cmake: show warning if libpsl is not found 2024-08-15 10:38:46 +02:00
appveyor.yml CI: add test timeouts, more cmake build tests, fix VS2010 C warning 2024-08-27 23:40:48 +02:00
buildconf copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
buildconf.bat buildconf.bat: remove outdated groff/nroff use 2024-03-07 22:38:16 +01:00
CHANGES.md CHANGES: rename to CHANGES.md, no longer generated 2024-08-01 13:37:12 +02:00
CMakeLists.txt cmake: default CURL_DISABLE_LDAPS to the value of CURL_DISABLE_LDAP 2024-09-02 21:03:01 +02:00
configure.ac printf: fix mingw-w64 format checks 2024-09-02 21:03:01 +02:00
COPYING COPYING: update copyright year 2024-01-08 18:40:06 +01:00
curl-config.in build: tidy up internal macro names for libcurl.pc 2024-08-12 14:56:41 +02:00
Dockerfile Dockerfile: update debian:bookworm-slim to 39868a6 2024-07-03 08:39:27 +02:00
GIT-INFO.md GIT-INFO.md: remove version requirements 2024-07-08 23:06:05 +02:00
libcurl.def lib: add curl_multi_waitfds 2024-04-09 16:53:40 +02:00
libcurl.pc.in build: tidy up internal macro names for libcurl.pc 2024-08-12 14:56:41 +02:00
Makefile.am cmake: migrate dependency detections to Find modules 2024-08-20 11:38:40 +02:00
Makefile.dist Makefile.mk: drop Windows support 2023-12-16 13:12:22 +00:00
maketgz dist: drop buildconf 2024-08-06 13:43:20 +02:00
README docs: minor grammar fixes 2022-09-29 10:44:12 +02:00
README.md README: refresh 2024-08-25 23:31:53 +02:00
RELEASE-NOTES autotools: settle with option name: --enable-windows-unicode 2024-09-01 18:43:28 +02:00
renovate.json GHA: unify http3 workflows into one 2024-06-01 10:57:23 +02:00
REUSE.toml CHANGES: rename to CHANGES.md, no longer generated 2024-08-01 13:37:12 +02:00
SECURITY.md docs: Clarify OpenSSF Best Practices vs Scorecard 2024-08-22 11:50:20 +02:00

curl logo

Curl is a command-line tool for transferring data specified with URL syntax. Learn how to use curl by reading the manpage or everything curl.

Find out how to install curl by reading the INSTALL document.

libcurl is the library curl is using to do its job. It is readily available to be used by your software. Read the libcurl manpage to learn how.

Open Source

curl is Open Source and is distributed under an MIT-like license.

Contact

Contact us on a suitable mailing list or use GitHub issues/ pull requests/ discussions.

All contributors to the project are listed in the THANKS document.

Commercial support

For commercial support, maybe private and dedicated help with your problems or applications using (lib)curl visit the support page.

Website

Visit the curl website for the latest news and downloads.

Source code

Download the latest source from the Git server:

git clone https://github.com/curl/curl.git

Security problems

Report suspected security problems via our HackerOne page and not in public.

Notice

Curl contains pieces of source code that is Copyright (c) 1998, 1999 Kungliga Tekniska Högskolan. This notice is included here to comply with the distribution terms.

Backers

Thank you to all our backers! 🙏 Become a backer.

Sponsors

Support this project by becoming a sponsor.