CURLOPT_ALTSVC.3: document the file format

Closes #9033
This commit is contained in:
Daniel Stenberg 2022-06-21 19:23:42 +02:00
parent 51e0b8fc60
commit d56dbf0a16
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -51,6 +51,35 @@ if(curl) {
curl_easy_perform(curl); curl_easy_perform(curl);
} }
.fi .fi
.SH "FILE FORMAT"
A text based file with one line per alt-svc entry and each line consists of
nine space-separated fields.
An example line could look like
h2 www.example 8443 h3 quic.example 443 "20190808 06:18:37" 1 0
The fields of that line are:
.IP h2
ALPN id for the source origin
.IP www.example
Host name for the source origin
.IP 8443
Port number for the source origin
.IP h3
ALPN id for the destination host
.IP quic.example
Host name for the destination host
.IP 443
Port number for the destination host
.IP 2019*
Expiration date and time of this entry within double quotes. The date format
is "YYYYMMDD HH:MM:SS" and the time zone is GMT.
.IP 1
Boolean (1 or 0) if "persist" was set for this entry
.IP 0
Integer priority value (not currently used)
.SH AVAILABILITY .SH AVAILABILITY
Added in 7.64.1 Added in 7.64.1
.SH RETURN VALUE .SH RETURN VALUE