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 454beb711b
websocket: support CURLOPT_READFUNCTION
Add support for CURLOPT_READFUNCTION with WebSocket urls when
    *not* in connect-only mode, e.g. when using curl_multi_perform.

    Install the callback function and set CURLOPT_UPLOAD. Return
    CURL_READFUNC_PAUSE when having nothing more to send and unpause
    the transfer when more data is ready.

    This will send the read bytes in a WebSocket BINARY frame.

    Add support for this mode in the pytest "ws_data" client and
    have all tests run in 'curl_ws_send/recv' and 'peform' mode
    as well.

    Add `curl_ws_start_frame()`. Document, cover in libcurl-ws.md
    and explain the READFUNCTION mode for websockets.

    Add example `websocket-updown` for this.
2025-07-31 10:51:22 +02:00
.circleci CI: sync curl download command-line options 2025-07-07 17:34:47 +02:00
.github GHA/distcheck: add more tarball builds 2025-07-31 00:41:36 +02:00
CMake windows: assume ADDRESS_FAMILY, drop feature checks 2025-07-29 02:06:35 +02:00
docs websocket: support CURLOPT_READFUNCTION 2025-07-31 10:51:22 +02:00
include websocket: support CURLOPT_READFUNCTION 2025-07-31 10:51:22 +02:00
lib websocket: support CURLOPT_READFUNCTION 2025-07-31 10:51:22 +02:00
LICENSES copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
m4 tidy-up: whitespace, indent, #if 0 2025-07-30 03:46:21 +02:00
packages tidy-up: more whitespace/indent, comments 2025-07-25 11:47:51 +02:00
plan9 copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
projects checksrc-all: rewrite in Perl, remove checksrc.bat 2025-07-11 12:28:46 +02:00
scripts websocket: support CURLOPT_READFUNCTION 2025-07-31 10:51:22 +02:00
src curl: make --retry-delay and --retry-max-time accept decimal seconds 2025-07-31 08:55:58 +02:00
tests websocket: support CURLOPT_READFUNCTION 2025-07-31 10:51:22 +02:00
winbuild vquic: drop msh3 2025-07-27 17:57:17 +02: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 tidy-up: .gitignore lines mostly 2025-01-27 20:59:46 +01:00
.mailmap ws: tests and fixes 2025-06-02 11:15:38 +02:00
acinclude.m4 build: drop HAVE_SYS_SOCKET_H and HAVE_SYS_TIME_H macros 2025-06-15 18:44:39 +02:00
appveyor.sh appveyor: drop VS2008 CI job, move OpenSSL 1.0.2 to VS2010 2025-07-01 19:47:01 +02:00
appveyor.yml windows: fix if_nametoindex() detection with autotools, improve with cmake 2025-07-21 13:30:01 +02: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 windows: assume ADDRESS_FAMILY, drop feature checks 2025-07-29 02:06:35 +02:00
configure.ac tidy-up: whitespace, indent, #if 0 2025-07-30 03:46:21 +02:00
COPYING COPYING: bump copyright year range to 1996 - 2025 2025-01-01 21:12:12 +01:00
curl-config.in curl-config: fix whitespace in usage text 2025-06-27 01:03:08 +02:00
Dockerfile GHA: update debian:bookworm-slim Docker digest to 2424c18 2025-07-22 19:47:47 +02:00
GIT-INFO.md build: drop tool_hugehelp.c.cvs, tidy up macros, drop buildconf.bat 2025-01-26 14:22:49 +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 vquic: drop msh3 2025-07-27 17:57:17 +02:00
README docs: minor grammar fixes 2022-09-29 10:44:12 +02:00
README.md spacecheck.pl: drop more exceptions 2025-05-13 16:01:07 +02:00
RELEASE-NOTES RELEASE-NOTES: synced 2025-07-30 09:31:18 +02:00
renovate.json ci: fix ldap install location and add renovate rule for openldap 2025-07-15 14:54:44 +01:00
REUSE.toml checksrc: reduce exceptions, apply again to curlx 2025-06-27 17:33:35 +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.