romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-05-17 02:46:22 +03:00
Code Issues Projects Releases Packages Wiki Activity
curl/docs/internals
History
Stefan Eissing 8f71d0fde5
creds: hold credentials 
Authorizdation credentials are kept in `struct Curl_creds`. This contains:

* `user`: the username, maybe the empty string
* `passwd`: the password, maybe the empty string
* `sasl_authzid`: the SASL authz value, maybe the empty string
* `oauth_bearer`: the OAUTH bearer token, maybe the empty string
* `source`: where the credentials from from
* `refcount`: a reference counter to link/unkink creds

A `creds` with all values empty is equivalent to NULL, e.g. no `creds`
instance. With reference counting, `creds` can be linked/unlinked
in several places.

See docs/internals/CREDENTIALS.md for use.

Closes #21548
2026-05-12 16:05:15 +02:00
..
BUFQ.md badwords: avoid 'simply' 2026-03-10 19:34:06 +01:00
BUFREF.md badwords: prefer 'null-terminated' 2026-03-18 11:40:13 +01:00
CHECKSRC.md docs: replace instances of the vague qualifier 'quite' 2026-03-07 23:52:50 +01:00
CLIENT-READERS.md docs: avoid starting sentences with However, 2026-03-07 23:49:11 +01:00
CLIENT-WRITERS.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
CODE_STYLE.md badwords: avoid 'simply' 2026-03-10 19:34:06 +01:00
CONNECTION-FILTERS.md docs: fixup wording nits 2026-03-09 22:47:07 +01:00
CREDENTIALS.md creds: hold credentials 2026-05-12 16:05:15 +02:00
CURLX.md curlx: move the docs to docs/internals/ 2025-05-13 10:30:02 +02:00
DYNBUF.md curlx: move into to curlx/ 2025-05-07 11:01:15 +02:00
HASH.md lib: add meta_hash to connection, eliminate hash_offt 2025-04-22 15:57:18 +02:00
LLIST.md tidy-up: miscellaneous 2026-03-09 11:35:19 +01:00
MID.md docs: avoid starting sentences with However, 2026-03-07 23:49:11 +01:00
MQTT.md MQTT.md: remove no TLS (mqtts) support 2026-01-18 16:43:18 +01:00
MULTI-EV.md docs: fixup wording nits 2026-03-09 22:47:07 +01:00
NEW-PROTOCOL.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
PEERS.md lib: introduce Curl_peer 2026-05-05 16:22:11 +02:00
PORTING.md docs/internals/PORTING.md: new document 2025-03-29 14:10:10 +01:00
RATELIMITS.md ratelimit: redesign 2025-11-24 23:34:05 +01:00
README.md docs/internals: new subdirectory 2024-08-16 08:59:25 +02:00
SCORECARD.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
SPLAY.md internals/SPLAY.md: internal API documentation 2024-08-16 17:13:37 +02:00
STRPARSE.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
THRDPOOL-AND-QUEUE.md spacecheck: verify filename lengths and characters 2026-03-25 18:56:40 +01:00
TIME-KEEPING.md docs: fixup wording nits 2026-03-09 22:47:07 +01:00
TLS-SESSIONS.md badwords: avoid 'simply' 2026-03-10 19:34:06 +01:00
UINT_SETS.md TIME-KEEPING.md: fold long lines 2025-12-18 23:00:06 +01:00
WEBSOCKET.md tidy-up: miscellaneous 2026-01-20 12:37:56 +01:00

README.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.