# grqz/curl-dev architecture

> Architecture diagram of the GitHub repository grqz/curl-dev, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/grqz/curl-dev
- Repository: https://github.com/grqz/curl-dev

## Overview

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: [`lib/request.c`](https://github.com/grqz/curl-dev/blob/master/lib/request.c) (Request handling), [`lib/transfer.c`](https://github.com/grqz/curl-dev/blob/master/lib/transfer.c) (Transfer engine), [`include/curl/curl.h`](https://github.com/grqz/curl-dev/blob/master/include/curl/curl.h) (Public API), [`lib/cfilters.c`](https://github.com/grqz/curl-dev/blob/master/lib/cfilters.c) (Connection filters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Command-line tool"]
  node_params["Parse options<br/>[tool_getparam.c]"]
  node_operate["Run transfers<br/>[tool_operate.c]"]
end

subgraph group_api["Public interfaces"]
  node_curlapi["Public API<br/>[curl.h]"]
  node_easy["Easy interface<br/>[easy.c]"]
  node_multi["Multi interface<br/>[multi.c]"]
  node_urlapi["URL API<br/>[urlapi.c]"]
end

subgraph group_runtime["Transfer runtime"]
  node_transfer["Transfer engine<br/>[transfer.c]"]
  node_request["Request handling<br/>[request.c]"]
  node_filters["Connection filters<br/>[cfilters.c]"]
  node_connect["Connection setup<br/>[connect.c]"]
  node_dns["Name resolution<br/>[hostip.c]"]
end

subgraph group_protocol["Protocols and security"]
  node_http["HTTP<br/>[http.c]"]
  node_ftp["FTP<br/>[ftp.c]"]
  node_otherprotocols["Other protocols"]
  node_tls["TLS backends"]
  node_ssh["SSH transfers"]
  node_auth["Authentication"]
end

subgraph group_state["Shared state"]
  node_state["Transfer state<br/>[urldata.h]"]
  node_conncache[("Connection cache<br/>[conncache.c]")]
  node_cookies[("Cookies<br/>[cookie.c]")]
end

node_user(("CLI user"))

node_user -->|"supplies options"| node_params
node_params -->|"configures"| node_operate
node_operate -.->|"uses libcurl"| node_easy
node_curlapi -.->|"exposes"| node_easy
node_curlapi -.->|"exposes"| node_multi
node_curlapi -.->|"exposes"| node_urlapi
node_easy -.->|"starts transfer"| node_transfer
node_multi -.->|"schedules transfers"| node_transfer
node_transfer -.->|"processes request"| node_request
node_transfer -.->|"uses filters"| node_filters
node_filters -.->|"connects"| node_connect
node_connect -.->|"resolves host"| node_dns
node_request -.->|"dispatches"| node_http
node_request -.->|"dispatches"| node_ftp
node_request -.->|"dispatches"| node_otherprotocols
node_filters -.->|"secures connection"| node_tls
node_request -.->|"dispatches"| node_ssh
node_http -.->|"uses authentication"| node_auth
node_transfer -.->|"uses transfer state"| node_state
node_connect -.->|"reuses connections"| node_conncache
node_http -.->|"uses cookies"| node_cookies

click node_params "https://github.com/grqz/curl-dev/blob/master/src/tool_getparam.c"
click node_operate "https://github.com/grqz/curl-dev/blob/master/src/tool_operate.c"
click node_curlapi "https://github.com/grqz/curl-dev/blob/master/include/curl/curl.h"
click node_easy "https://github.com/grqz/curl-dev/blob/master/lib/easy.c"
click node_multi "https://github.com/grqz/curl-dev/blob/master/lib/multi.c"
click node_urlapi "https://github.com/grqz/curl-dev/blob/master/lib/urlapi.c"
click node_transfer "https://github.com/grqz/curl-dev/blob/master/lib/transfer.c"
click node_request "https://github.com/grqz/curl-dev/blob/master/lib/request.c"
click node_filters "https://github.com/grqz/curl-dev/blob/master/lib/cfilters.c"
click node_connect "https://github.com/grqz/curl-dev/blob/master/lib/connect.c"
click node_dns "https://github.com/grqz/curl-dev/blob/master/lib/hostip.c"
click node_http "https://github.com/grqz/curl-dev/blob/master/lib/http.c"
click node_ftp "https://github.com/grqz/curl-dev/blob/master/lib/ftp.c"
click node_otherprotocols "https://github.com/grqz/curl-dev/tree/master/lib"
click node_tls "https://github.com/grqz/curl-dev/tree/master/lib/vtls"
click node_ssh "https://github.com/grqz/curl-dev/tree/master/lib/vssh"
click node_auth "https://github.com/grqz/curl-dev/tree/master/lib/vauth"
click node_state "https://github.com/grqz/curl-dev/blob/master/lib/urldata.h"
click node_conncache "https://github.com/grqz/curl-dev/blob/master/lib/conncache.c"
click node_cookies "https://github.com/grqz/curl-dev/blob/master/lib/cookie.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_params,node_operate,node_user toneBlue
class node_curlapi,node_easy,node_multi,node_urlapi toneAmber
class node_transfer,node_request,node_filters,node_connect,node_dns toneMint
class node_http,node_ftp,node_otherprotocols,node_tls,node_ssh,node_auth toneRose
class node_state,node_conncache,node_cookies toneIndigo
```

## Components

### Command-line tool

- [Parse options](https://github.com/grqz/curl-dev/blob/master/src/tool_getparam.c): `src/tool_getparam.c`
- [Run transfers](https://github.com/grqz/curl-dev/blob/master/src/tool_operate.c): `src/tool_operate.c`

### Public interfaces

- [Public API](https://github.com/grqz/curl-dev/blob/master/include/curl/curl.h): `include/curl/curl.h`
- [Easy interface](https://github.com/grqz/curl-dev/blob/master/lib/easy.c): `lib/easy.c`
- [Multi interface](https://github.com/grqz/curl-dev/blob/master/lib/multi.c): `lib/multi.c`
- [URL API](https://github.com/grqz/curl-dev/blob/master/lib/urlapi.c): `lib/urlapi.c`

### Transfer runtime

- [Transfer engine](https://github.com/grqz/curl-dev/blob/master/lib/transfer.c): `lib/transfer.c`
- [Request handling](https://github.com/grqz/curl-dev/blob/master/lib/request.c): `lib/request.c`
- [Connection filters](https://github.com/grqz/curl-dev/blob/master/lib/cfilters.c): `lib/cfilters.c`
- [Connection setup](https://github.com/grqz/curl-dev/blob/master/lib/connect.c): `lib/connect.c`
- [Name resolution](https://github.com/grqz/curl-dev/blob/master/lib/hostip.c): `lib/hostip.c`

### Protocols and security

- [HTTP](https://github.com/grqz/curl-dev/blob/master/lib/http.c): `lib/http.c`
- [FTP](https://github.com/grqz/curl-dev/blob/master/lib/ftp.c): `lib/ftp.c`
- [Other protocols](https://github.com/grqz/curl-dev/tree/master/lib): `lib`
- [TLS backends](https://github.com/grqz/curl-dev/tree/master/lib/vtls): `lib/vtls`
- [SSH transfers](https://github.com/grqz/curl-dev/tree/master/lib/vssh): `lib/vssh`
- [Authentication](https://github.com/grqz/curl-dev/tree/master/lib/vauth): `lib/vauth`

### Shared state

- [Transfer state](https://github.com/grqz/curl-dev/blob/master/lib/urldata.h): `lib/urldata.h`
- [Connection cache](https://github.com/grqz/curl-dev/blob/master/lib/conncache.c): `lib/conncache.c`
- [Cookies](https://github.com/grqz/curl-dev/blob/master/lib/cookie.c): `lib/cookie.c`

### Other components

- **CLI user**

## Connections

- CLI user → Parse options: supplies options (evidence: `src/tool_getparam.c`)
- Parse options → Run transfers: configures (evidence: `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
