curl/docs
Christopher Dannemiller c78044c07e multi: fix curl_multi_waitfds reporting of fd_count
- Make curl_multi_waitfds consistent with the documentation.

Issue Addressed:

 - The documentation of curl_multi_waitfds indicates that users should
   be able to call curl_multi_waitfds with a NULL ufds. However, before
   this change, the function would return CURLM_BAD_FUNCTION_ARGUMENT.
 - Additionally, the documentation suggests that users can use this
   function to determine the number of file descriptors (fds) needed.
   However, the function would stop counting fds if the supplied fds
   were exhausted.

Changes Made:

 - NULL ufds Handling: curl_multi_waitfds can now accept a NULL ufds if
   size is also zero.
 - Counting File Descriptors: If curl_multi_waitfds is passed a NULL
   ufds, or the size of ufds is insufficient, the output parameter
   fd_count will return the number of fds needed. This value may be
   higher than actually needed but never lower.

Testing:

 - Test 2405 has been updated to cover the usage scenarios described
   above.

Fixes https://github.com/curl/curl/issues/15146
Closes https://github.com/curl/curl/pull/15155
2024-12-29 01:05:09 -05:00
..
cmdline-opts curl: make --etag-save acknowledge --create-dirs 2024-12-21 14:12:16 +01:00
examples clang-tidy: add to CI, add cmake support, fix fallouts 2024-12-27 13:42:32 +01:00
internals hyper: drop support 2024-12-21 11:33:05 +01:00
libcurl multi: fix curl_multi_waitfds reporting of fd_count 2024-12-29 01:05:09 -05:00
.gitignore
ALTSVC.md
BINDINGS.md
BUG-BOUNTY.md
BUGS.md docs/BUGS.md: remove leading space from a link 2024-12-14 14:22:38 +01:00
CIPHERS-TLS12.md
CIPHERS.md
CMakeLists.txt
CODE_OF_CONDUCT.md
CODE_REVIEW.md
CONTRIBUTE.md
curl-config.md
CURL-DISABLE.md
CURLDOWN.md
DEPRECATE.md hyper: drop support 2024-12-21 11:33:05 +01:00
DISTROS.md
EARLY-RELEASE.md
ECH.md
EXPERIMENTAL.md hyper: drop support 2024-12-21 11:33:05 +01:00
FAQ
FEATURES.md
GOVERNANCE.md
HELP-US.md
HISTORY.md tidy-up: misc 2024-12-24 01:27:26 +01:00
HSTS.md
HTTP3.md
HTTP-COOKIES.md
INSTALL
INSTALL-CMAKE.md clang-tidy: add to CI, add cmake support, fix fallouts 2024-12-27 13:42:32 +01:00
INSTALL.md Makefile.mk: drop in favour of autotools and cmake (MS-DOS, AmigaOS3) 2024-12-16 23:20:55 +01:00
INTERNALS.md
IPFS.md
KNOWN_BUGS
MAIL-ETIQUETTE.md
Makefile.am hyper: drop support 2024-12-21 11:33:05 +01:00
MANUAL.md
mk-ca-bundle.md
options-in-versions
README.md
RELEASE-PROCEDURE.md RELEASE-PROCEDURE.md: mention how to publish security advisories 2024-12-11 11:11:32 +01:00
ROADMAP.md
RUSTLS.md
SECURITY-ADVISORY.md
SPONSORS.md
SSL-PROBLEMS.md
SSLCERTS.md
THANKS THANKS: contributors from 8.11.1 2024-12-11 08:05:13 +01:00
THANKS-filter
TheArtOfHttpScripting.md
TODO TODO: sending only part of --data is now possible 2024-12-21 12:30:39 +01:00
URL-SYNTAX.md
VERSIONS.md
VULN-DISCLOSURE-POLICY.md VULN-DISCLOSURE-POLICY.md: mention the not setting CVSS 2024-12-19 22:59:54 +01:00

curl logo

Documentation

You find a mix of various documentation in this directory and subdirectories, using several different formats. Some of them are not ideal for reading directly in your browser.

If you would rather see the rendered version of the documentation, check out the curl website's documentation section for general curl stuff or the libcurl section for libcurl related documentation.