From 324a97ecf82e5e415c3c9fb4df093053c1efedf1 Mon Sep 17 00:00:00 2001 From: Diego Bes Date: Fri, 18 Mar 2016 15:25:56 -0700 Subject: http2: support "prior knowledge", no upgrade from HTTP/1.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Supports HTTP/2 over clear TCP - Optimize switching to HTTP/2 by removing calls to init and setup before switching. Switching will eventually call setup and setup calls init. - Supports new version to “force” the use of HTTP/2 over clean TCP - Add common line parameter “--http2-prior-knowledge” to the Curl command line tool. --- docs/HTTP2.md | 3 +++ docs/curl.1 | 5 +++++ docs/libcurl/symbols-in-versions | 1 + 3 files changed, 9 insertions(+) (limited to 'docs') diff --git a/docs/HTTP2.md b/docs/HTTP2.md index 81b3d5e21..5294ab5fa 100644 --- a/docs/HTTP2.md +++ b/docs/HTTP2.md @@ -96,6 +96,9 @@ curl tool curl offers the `--http2` command line option to enable use of HTTP/2. +curl offers the `--http2-prior-knowledge` command line option to enable use of +HTTP/2 without HTTP/1.1 Upgrade. + Since 7.47.0, the curl tool enables HTTP/2 by default for HTTPS connections. HTTP Alternative Services diff --git a/docs/curl.1 b/docs/curl.1 index 0b0f4d29d..4a61b6554 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -150,6 +150,11 @@ version. (Added in 7.33.0) .IP "--http2" (HTTP) Tells curl to issue its requests using HTTP 2. This requires that the underlying libcurl was built to support it. (Added in 7.33.0) +.IP "--http2-prior-knowledge" +(HTTP) Tells curl to issue its requests using HTTP 2 without HTTP/1.1 Upgrade. +This requires prior knowledge that the server supports HTTP 2. +This requires that the underlying libcurl was built to support it. +(Added in 7.49.0) .IP "--no-npn" Disable the NPN TLS extension. NPN is enabled by default if libcurl was built with an SSL library that supports NPN. NPN is used by a libcurl that supports diff --git a/docs/libcurl/symbols-in-versions b/docs/libcurl/symbols-in-versions index daf1809ab..2e4f15f39 100644 --- a/docs/libcurl/symbols-in-versions +++ b/docs/libcurl/symbols-in-versions @@ -695,6 +695,7 @@ CURL_HTTP_VERSION_1_1 7.9.1 CURL_HTTP_VERSION_2 7.43.0 CURL_HTTP_VERSION_2_0 7.33.0 CURL_HTTP_VERSION_2TLS 7.47.0 +CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE 7.49.0 CURL_HTTP_VERSION_NONE 7.9.1 CURL_IPRESOLVE_V4 7.10.8 CURL_IPRESOLVE_V6 7.10.8 -- cgit v1.2.3