curl/docs/internals
Stefan Eissing cfc657a48d
multi: event based rework
Rework the event based handling of transfers and connections to
be "localized" into a single source file with clearer dependencies.

- add multi_ev.c and multi_ev.h
- add docs/internal/MULTI-EV.md to explain the overall workings
- only do event handling book keeping when the socket callback
  is set
- add handling for "connection only" event tracking, when internal
  easy handles are used that are not really tied to a connection.
  Used in connection pool.
- remove transfer member "last_poll" and connections "shutdown_poll"
  and keep all that internal to multi_ev.c
- add CURL_TRC_M() for tracing of "multi" related things, including
  event handling and connection pool operations. Add new trace
  feature "multi" for trace config.
  multi traces will show exactly what is going on in regard to
  event handling.
- multi: trace transfers "mstate" in every CURL_TRC_M() call
- make internal trace buffer 2048 bytes and end the silliness
  with +n here -m there. Adjust test 1652 expectations of resulting
  length and input edge cases.
- add trace feature "lib-ids" to perfix libcurl traces with transfer
  and connection ids. Useful for debugging libcurl applications.

Closes #16308
2025-02-22 14:47:40 +01:00
..
BUFQ.md docs: use lowercase curl and libcurl 2025-01-02 17:15:54 +01:00
BUFREF.md
CHECKSRC.md
CLIENT-READERS.md
CLIENT-WRITERS.md
CODE_STYLE.md CODE_STYLE: readability and banned functions 2025-02-16 16:11:13 +01:00
CONNECTION-FILTERS.md
DYNBUF.md lib: TLS session ticket caching reworked 2024-12-20 14:59:23 +01:00
HASH.md
LLIST.md docs: use lowercase curl and libcurl 2025-01-02 17:15:54 +01:00
MQTT.md docs: use lowercase curl and libcurl 2025-01-02 17:15:54 +01:00
MULTI-EV.md multi: event based rework 2025-02-22 14:47:40 +01:00
NEW-PROTOCOL.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
README.md
SPLAY.md
STRPARSE.md strparse: provide access functions 2025-02-19 12:17:32 +01:00
TLS-SESSIONS.md docs/TLS-SESSIONS: fix typo, the->they 2025-01-21 09:23:26 +01:00
WEBSOCKET.md hyper: drop support 2024-12-21 11:33:05 +01:00

Internals

This directory contains documentation covering libcurl internals; APIs and concepts that are useful for contributors and maintainers.

Public APIs are documented in the public documentation, not here.