From: Daniel Stenberg <daniel@haxx.se>
Date: Tue, 21 Jun 2022 17:23:42 +0000 (+0200)
Subject: CURLOPT_ALTSVC.3: document the file format
X-Git-Tag: curl-7_84_0~21
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=d56dbf0a1653302796b1e9493fef5c3af4bf133b;p=thirdparty%2Fcurl.git

CURLOPT_ALTSVC.3: document the file format

Closes #9033
---

diff --git a/docs/libcurl/opts/CURLOPT_ALTSVC.3 b/docs/libcurl/opts/CURLOPT_ALTSVC.3
index d9875022d9..38c2bab256 100644
--- a/docs/libcurl/opts/CURLOPT_ALTSVC.3
+++ b/docs/libcurl/opts/CURLOPT_ALTSVC.3
@@ -51,6 +51,35 @@ if(curl) {
   curl_easy_perform(curl);
 }
 .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
 Added in 7.64.1
 .SH RETURN VALUE