aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/alt-svc.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cmdline-opts/alt-svc.md')
-rw-r--r--docs/cmdline-opts/alt-svc.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/cmdline-opts/alt-svc.md b/docs/cmdline-opts/alt-svc.md
new file mode 100644
index 000000000..0a0f17df5
--- /dev/null
+++ b/docs/cmdline-opts/alt-svc.md
@@ -0,0 +1,28 @@
+---
+c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
+SPDX-License-Identifier: curl
+Long: alt-svc
+Arg: <file name>
+Protocols: HTTPS
+Help: Enable alt-svc with this cache file
+Added: 7.64.1
+Category: http
+Multi: append
+See-also:
+ - resolve
+ - connect-to
+Example:
+ - --alt-svc svc.txt $URL
+---
+
+# `--alt-svc`
+
+This option enables the alt-svc parser in curl. If the file name points to an
+existing alt-svc cache file, that gets used. After a completed transfer, the
+cache is saved to the file name again if it has been modified.
+
+Specify a "" file name (zero length) to avoid loading/saving and make curl
+just handle the cache in memory.
+
+If this option is used several times, curl loads contents from all the
+files but the last one is used for saving.