diff options
author | Daniel Stenberg <daniel@haxx.se> | 2019-08-07 14:17:48 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2019-08-08 08:17:24 +0200 |
commit | 026840e35c7359c23741afe633bd3ab4b121c4ed (patch) | |
tree | fc931e91538dfd07ecc6653e897a4491cfb8cc3f /docs/cmdline-opts | |
parent | 317076876a056d26175e07e21bd32f9889bf8ea2 (diff) |
CURLOPT_HTTP_VERSION: seting this to 3 forces HTTP/3 use directly
Even though it cannot fall-back to a lower HTTP version automatically. The
safer way to upgrade remains via CURLOPT_ALTSVC.
CURLOPT_H3 no longer has any bits that do anything and might be removed
before we remove the experimental label.
Updated the curl tool accordingly to use "--http3".
Closes #4197
Diffstat (limited to 'docs/cmdline-opts')
-rw-r--r-- | docs/cmdline-opts/Makefile.inc | 2 | ||||
-rw-r--r-- | docs/cmdline-opts/http2.d | 1 | ||||
-rw-r--r-- | docs/cmdline-opts/http3.d (renamed from docs/cmdline-opts/http3-direct.d) | 5 |
3 files changed, 6 insertions, 2 deletions
diff --git a/docs/cmdline-opts/Makefile.inc b/docs/cmdline-opts/Makefile.inc index 1bdda9885..6b4387475 100644 --- a/docs/cmdline-opts/Makefile.inc +++ b/docs/cmdline-opts/Makefile.inc @@ -65,7 +65,7 @@ DPAGES = \ http1.0.d \ http1.1.d http2.d \ http2-prior-knowledge.d \ - http3-direct.d \ + http3.d \ ignore-content-length.d \ include.d \ insecure.d \ diff --git a/docs/cmdline-opts/http2.d b/docs/cmdline-opts/http2.d index 04cff00a4..cf8f2988e 100644 --- a/docs/cmdline-opts/http2.d +++ b/docs/cmdline-opts/http2.d @@ -6,5 +6,6 @@ Mutexed: http1.1 http1.0 http2-prior-knowledge Requires: HTTP/2 See-also: no-alpn Help: Use HTTP 2 +See-also: http1.1 http3 --- Tells curl to use HTTP version 2. diff --git a/docs/cmdline-opts/http3-direct.d b/docs/cmdline-opts/http3.d index fb8c8cf28..ca85e3a64 100644 --- a/docs/cmdline-opts/http3-direct.d +++ b/docs/cmdline-opts/http3.d @@ -1,10 +1,11 @@ -Long: http3-direct +Long: http3 Tags: Versions Protocols: HTTP Added: 7.66.0 Mutexed: http1.1 http1.0 http2 http2-prior-knowledge Requires: HTTP/3 Help: Use HTTP v3 +See-also: http1.1 http2 --- WARNING: this option is experiemental. Do not use in production. @@ -14,3 +15,5 @@ the URL. A normal HTTP/3 transaction will be done to a host and then get redirected via Alt-SVc, but this option allows a user to circumvent that when you know that the target speaks HTTP/3 on the given host and port. +This option will make curl fail if a QUIC connection cannot be established, it +cannot fall back to a lower HTTP version on its own. |