| 1 |
# Alt-Svc |
| 2 |
|
| 3 |
curl features **EXPERIMENTAL** support for the Alt-Svc: HTTP header. |
| 4 |
|
| 5 |
## Enable Alt-Svc in build |
| 6 |
|
| 7 |
`./configure --enable-alt-svc` |
| 8 |
|
| 9 |
## Standard |
| 10 |
|
| 11 |
[RFC 7838](https://tools.ietf.org/html/rfc7838) |
| 12 |
|
| 13 |
# Alt-Svc cache file format |
| 14 |
|
| 15 |
This a text based file with one line per entry and each line consists of nine |
| 16 |
space separated fields. |
| 17 |
|
| 18 |
## Example |
| 19 |
|
| 20 |
h2 quic.tech 8443 h3-22 quic.tech 8443 "20190808 06:18:37" 0 0 |
| 21 |
|
| 22 |
## Fields |
| 23 |
|
| 24 |
1. The ALPN id for the source origin |
| 25 |
2. The host name for the source origin |
| 26 |
3. The port number for the source origin |
| 27 |
4. The ALPN id for the destination host |
| 28 |
5. The host name for the destination host |
| 29 |
6. The host number for the destination host |
| 30 |
7. The expiration date and time of this entry within double quotes. The date format is "YYYYMMDD HH:MM:SS" and the time zone is GMT. |
| 31 |
8. Boolean (1 or 0) if "persist" was set for this entry |
| 32 |
9. Integer priority value (not currently used) |
| 33 |
|
| 34 |
# TODO |
| 35 |
|
| 36 |
- handle multiple response headers, when one of them says `clear` (should |
| 37 |
override them all) |
| 38 |
- using `Age:` value for caching age as per spec |
| 39 |
- `CURLALTSVC_IMMEDIATELY` support |