docs/ALTSVC.md: first basic file format description

diff --git a/docs/ALTSVC.md b/docs/ALTSVC.md
index 5aca1c95047b9f6f813453a84c5c39d87cdf2248..e44319ce19ad74b1230220e4df76a3403f5d9bea 100644 (file)
--- a/docs/ALTSVC.md
+++ b/docs/ALTSVC.md
@@ -57,3 +57,24 @@ Experimental support in curl means:
 - using `Age:` value for caching age as per spec
 - `CURLALTSVC_IMMEDIATELY` support
 - `CURLALTSVC_ALTUSED` support
+
+# Alt-Svc cache file format
+
+This a text based file with one line per entry and each line consists of nine
+space separated fields.
+
+## Example
+
+    h2 quic.tech 8443 h3-22 quic.tech 8443 "20190808 06:18:37" 0 0
+
+## Fields
+
+1. The ALPN id for the source origin
+2. The host name for the source origin
+3. The port number for the source origin
+4. The ALPN id for the destination host
+5. The host name for the destination host
+6. The host number for the destination host
+7. Within double quotes, the expiration date of this entry
+8. Boolean (1 or 0) if "persist" was set for this entry
+9. Integer priority value (not currently used)