How grqz/curl-dev works
curl is both a command-line URL data-transfer tool and the libcurl library it uses. The principal workflow is that a user supplies transfer options and URLs, the CLI configures libcurl, and libcurl performs a protocol transfer and reports results. The runtime also includes asynchronous multi-transfer support, URL APIs, protocol handlers, connection filters, TLS backends, authentication, and shared transfer state. The README establishes the product split; source-index references identify major internal modules, but many runtime call paths were not excerpted, so uncertain links are left dashed.
Main entry points: request.c Request handling · transfer.c Transfer engine · curl.h Public API · cfilters.c Connection filters
Components 21
Command-line tool
- Parse options
src/tool_getparam.c - Run transfers
src/tool_operate.c
Public interfaces
- Public API
include/curl/curl.h - Easy interface
lib/easy.c - Multi interface
lib/multi.c - URL API
lib/urlapi.c
Transfer runtime
- Transfer engine
lib/transfer.c - Request handling
lib/request.c - Connection filters
lib/cfilters.c - Connection setup
lib/connect.c - Name resolution
lib/hostip.c
Protocols and security
- HTTP
lib/http.c - FTP
lib/ftp.c - Other protocols
lib - TLS backends
lib/vtls - SSH transfers
lib/vssh - Authentication
lib/vauth
Shared state
- Transfer state
lib/urldata.h - Connection cache
lib/conncache.c - Cookies
lib/cookie.c
Other components
- CLI user
Connections 21
- CLI user → Parse options: supplies options
src/tool_getparam.c - Parse options → Run transfers: configures
src/tool_operate.c - Run transfers → Easy interface: uses libcurl
- Public API → Easy interface: exposes
- Public API → Multi interface: exposes
- Public API → URL API: exposes
- Easy interface → Transfer engine: starts transfer
- Multi interface → Transfer engine: schedules transfers
- Transfer engine → Request handling: processes request
- Transfer engine → Connection filters: uses filters
- Connection filters → Connection setup: connects
- Connection setup → Name resolution: resolves host
- Request handling → HTTP: dispatches
- Request handling → FTP: dispatches
- Request handling → Other protocols: dispatches
- Connection filters → TLS backends: secures connection
- Request handling → SSH transfers: dispatches
- HTTP → Authentication: uses authentication
- Transfer engine → Transfer state: uses transfer state
- Connection setup → Connection cache: reuses connections
- HTTP → Cookies: uses cookies