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/http3.d | |
parent | 317076876a056d26175e07e21bd32f9889bf8ea2 (diff) | |
download | curl-026840e35c7359c23741afe633bd3ab4b121c4ed.tar.gz |
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/http3.d')
-rw-r--r-- | docs/cmdline-opts/http3.d | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/cmdline-opts/http3.d b/docs/cmdline-opts/http3.d new file mode 100644 index 000000000..ca85e3a64 --- /dev/null +++ b/docs/cmdline-opts/http3.d @@ -0,0 +1,19 @@ +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. + +Tells curl to use HTTP version 3 directly to the host and port number used in +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. |