curl/curl
1
1
Fork 0
mirror of https://github.com/curl/curl.git synced 2025-09-21 03:22:41 +03:00
Code Issues Packages Projects Releases Wiki Activity

http2: more documentation for prior knowledge

Browse Source
This commit is contained in:
Daniel Stenberg 2016-03-31 22:04:09 +02:00
parent 324a97ecf8
commit 213d3c7b0c
2 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/curl.1
View File

@ -151,10 +151,13 @@ version. (Added in 7.33.0)
(HTTP) Tells curl to issue its requests using HTTP 2. This requires that the (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) underlying libcurl was built to support it. (Added in 7.33.0)
.IP "--http2-prior-knowledge" .IP "--http2-prior-knowledge"
(HTTP) Tells curl to issue its requests using HTTP 2 without HTTP/1.1 Upgrade. (HTTP) Tells curl to issue its non-TLS HTTP requests using HTTP/2 without
This requires prior knowledge that the server supports HTTP 2. HTTP/1.1 Upgrade. It requires prior knowledge that the server supports HTTP/2
This requires that the underlying libcurl was built to support it. straight away. HTTPS requests will still do HTTP/2 the standard way with
(Added in 7.49.0) negotiated protocol version in the TLS handshake.
HTTP/2 support in general also requires that the underlying libcurl was built
to support it. (Added in 7.49.0)
.IP "--no-npn" .IP "--no-npn"
Disable the NPN TLS extension. NPN is enabled by default if libcurl was built 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 with an SSL library that supports NPN. NPN is used by a libcurl that supports

7
docs/libcurl/opts/CURLOPT_HTTP_VERSION.3
View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2016, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -54,6 +54,11 @@ actual protocol name.
Attempt HTTP 2 over TLS (HTTPS) only. libcurl will fall back to HTTP 1.1 if Attempt HTTP 2 over TLS (HTTPS) only. libcurl will fall back to HTTP 1.1 if
HTTP 2 can't be negotiated with the HTTPS server. For clear text HTTP servers, HTTP 2 can't be negotiated with the HTTPS server. For clear text HTTP servers,
libcurl will use 1.1. (Added in 7.47.0) libcurl will use 1.1. (Added in 7.47.0)
.IP CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE
Issue non-TLS HTTP requests using HTTP/2 without HTTP/1.1 Upgrade. It requires
prior knowledge that the server supports HTTP/2 straight away. HTTPS requests
will still do HTTP/2 the standard way with negotiated protocol version in the
TLS handshake.
.SH DEFAULT .SH DEFAULT
CURL_HTTP_VERSION_NONE CURL_HTTP_VERSION_NONE
.SH PROTOCOLS .SH PROTOCOLS