curl/docs/internals
Stefan Eissing bc40e09f63
lib: introduce Curl_peer
`struct Curl_peer` keeps information about a communication endpoint
together. It will replace `conn->host` and `conn->conn_to_host` and
proxyinfo host. It will also become part of `struct ssl_peer`.

It has a reference counter, so an instance can be shared between
connections and filters.

Elminiates `conn->host` and `conn->connect_to_host`, used in the
proxyinfo structures. Passed to DNS resolution and socks filters, etc.

Pass peer to http proxy and socks tunnel filters. Use peer in dns filter
and resolving. Make `Curl_peer` a member in the `struct ssl_peer`.

Add `docs/internals/PEERS.md` for documentation.

Closes #21472
2026-05-05 16:22:11 +02:00
..
BUFQ.md
BUFREF.md
CHECKSRC.md
CLIENT-READERS.md
CLIENT-WRITERS.md
CODE_STYLE.md
CONNECTION-FILTERS.md docs: fixup wording nits 2026-03-09 22:47:07 +01:00
CURLX.md
DYNBUF.md
HASH.md
LLIST.md
MID.md
MQTT.md
MULTI-EV.md
NEW-PROTOCOL.md
PEERS.md
PORTING.md
RATELIMITS.md
README.md
SCORECARD.md
SPLAY.md
STRPARSE.md
THRDPOOL-AND-QUEUE.md
TIME-KEEPING.md
TLS-SESSIONS.md
UINT_SETS.md TIME-KEEPING.md: fold long lines 2025-12-18 23:00:06 +01:00
WEBSOCKET.md

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.