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
Find a file
Stefan Eissing feea968512
conncontrol: reuse handling
Add protocol handler flag `PROTOPT_CONN_REUSE` to indicate that the
protocol allows reusing connections for other tranfers. Add that
to all handlers that support it.

Create connections with `conn->bits.close = FALSE` and remove all
the `connkeep()` calls in protocol handlers setup/connect implementations.
`PROTOPT_CONN_REUSE` assures that the default behaviour applies
at the end of a transfer without need to juggle the close bit.

`conn->bits.close` now serves as an additional indication that a
connection cannot be reused. Only protocol handles that allow
reuse need to set it to override the default behaviour.

Remove all `connclose()` and `connkeep()` calls from connection
filters. Filters should not modify connection flags. They are
supposed to run in eyeballing situations where a filter is just
one of many determining the outcome.

Fix http response header handling to only honour `Connection: close`
for HTTP/1.x versions.

Closes #19333
2025-11-27 14:30:14 +01:00
.circleci runtests: detect bad libssh differently for test 1459 (fixing CircleCI libssh job) 2025-11-16 23:28:44 +01:00
.github autotools: add nettle library detection via pkg-config (for GnuTLS) 2025-11-26 12:39:30 +01:00
CMake cmake: add support for libbacktrace, fix two build issues 2025-11-24 14:29:29 +01:00
docs docs: add rustls to supported backends for CERT and KEY 2025-11-27 08:38:25 +01:00
include build: add build-level CURL_DISABLE_TYPECHECK options 2025-11-21 13:48:35 +01:00
lib conncontrol: reuse handling 2025-11-27 14:30:14 +01:00
LICENSES krb5: drop support for Kerberos FTP 2025-09-20 23:58:28 +02:00
m4 autotools: add nettle library detection via pkg-config (for GnuTLS) 2025-11-26 12:39:30 +01:00
packages badwords: add more contractions, fix fallouts 2025-11-17 19:29:15 +01:00
plan9 tidy-up: LibreSSL Git repository URLs and local CI builds 2025-10-01 12:55:20 +02:00
projects projects/README.md: Markdown fixes 2025-11-17 15:09:09 +01:00
scripts docs: spell it Rustls with a capital R 2025-11-26 09:41:09 +01:00
src types: remove curl_int64_t/curl_uint64_t 2025-11-26 13:53:53 +01:00
tests test433: verify "Note: Read config file from..." 2025-11-27 08:39:40 +01:00
.dir-locals.el copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
.editorconfig .editorconfig: add 2025-09-02 08:36:40 +02: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 build: drop the winbuild build system 2025-09-20 01:20:25 +02:00
.mailmap REUSE: add copyright header to two files 2025-11-03 16:08:52 +01:00
acinclude.m4 badwords: add more contractions, fix fallouts 2025-11-17 19:29:15 +01:00
appveyor.sh appveyor: add VS2010 x86 Release VS project job and switch VS2013 to x64 2025-11-17 15:50:24 +01:00
appveyor.yml appveyor: add VS2010 x86 Release VS project job and switch VS2013 to x64 2025-11-17 15:50:24 +01:00
buildconf copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
CHANGES.md CHANGES: rename to CHANGES.md, no longer generated 2024-08-01 13:37:12 +02:00
CMakeLists.txt cmake: add support for libbacktrace, fix two build issues 2025-11-24 14:29:29 +01:00
configure.ac memdebug: produce stack trace dump with libbacktrace 2025-11-24 11:58:18 +01:00
COPYING COPYING: bump copyright year range to 1996 - 2025 2025-01-01 21:12:12 +01:00
curl-config.in curl-config: remove X prefix use 2025-08-04 10:01:07 +02:00
Dockerfile Dockerfile: update debian:bookworm-slim digest to 936abff 2025-11-05 15:24:21 +01:00
GIT-INFO.md REUSE: add copyright header to two files 2025-11-03 16:08:52 +01:00
libcurl.pc.in configure: do not echo most inherited LDFLAGS to config files 2024-11-14 09:55:45 +01:00
Makefile.am cmake: add support for libbacktrace, fix two build issues 2025-11-24 14:29:29 +01:00
README krb5: drop support for Kerberos FTP 2025-09-20 23:58:28 +02:00
README.md badwords: re-sync with curl-www, fix issues found 2025-11-12 00:53:44 +01:00
RELEASE-NOTES RELEASE-NOTES: synced 2025-11-24 23:32:59 +01:00
renovate.json renovate.json: replace CI: prefix with GHA: 2025-11-17 16:50:20 +01:00
REUSE.toml tests/data: add %includetext, dedupe XML payloads into external file 2025-11-13 12:24:50 +01: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 from or to a server using URLs. It supports these protocols: 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.

Learn how to use curl by reading the man page 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 man page 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.

Backers

Thank you to all our backers 🙏 Become a backer.

Sponsors

Support this project by becoming a sponsor.