moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-12-22 16:18:48 -05:00
Code Issues Releases Wiki Activity

http2: minor update of the README

Browse Source
This commit is contained in:
Daniel Stenberg 2014-02-05 15:31:29 +01:00
parent 133cdd29ea
commit 06b4275c0d
1 changed files with 28 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
lib/README.http2
View File

@ -1,28 +1,48 @@
HTTP2 with libcurl HTTP2 with libcurl
Spec: http://tools.ietf.org/html/draft-ietf-httpbis-http2-06 Spec: http://tools.ietf.org/html/draft-ietf-httpbis-http2
nghttp2 (https://github.com/tatsuhiro-t/nghttp2) nghttp2 (https://github.com/tatsuhiro-t/nghttp2)
We're depending on this 3rd party library for the actual low level protocol libcurl uses this 3rd party library for the low level protocol handling
handling parts. The reason for this is that HTTP2 is much more complex at parts. The reason for this is that HTTP2 is much more complex at that layer
that layer than HTTP1.1 (which we implement on our own) and that nghttp2 is than HTTP1.1 (which we implement on our own) and that nghttp2 is an already
an already existing and well functional library. existing and well functional library.
Right now, nghttp2 implements http2 draft-09
Over an http:// URL Over an http:// URL
If CURLOPT_HTTP_VERSION is set to CURL_HTTP_VERSION_2, libcurl will include If CURLOPT_HTTP_VERSION is set to CURL_HTTP_VERSION_2, libcurl will include
an upgrade header in the initial request to the host to allow upgrading to an upgrade header in the initial request to the host to allow upgrading to
http2. Possibly introduce an option that will cause libcurl to fail if not http2.
possible to upgrade. Possibly introduce an option that makes libcurl use
http2 at once over http:// Possibly we can later introduce an option that will cause libcurl to fail if
not possible to upgrade. Possibly we introduce an option that makes libcurl
use http2 at once over http://
Over an https:// URL Over an https:// URL
If CURLOPT_HTTP_VERSION is set to CURL_HTTP_VERSION_2, libcurl will use ALPN If CURLOPT_HTTP_VERSION is set to CURL_HTTP_VERSION_2, libcurl will use ALPN
(or NPN) to negotiate which protocol to continue with. Possibly introduce an (or NPN) to negotiate which protocol to continue with. Possibly introduce an
option that will cause libcurl to fail if not possible to use http2. option that will cause libcurl to fail if not possible to use http2.
Consider options to explicitly disable ALPN and/or NPN.
SSL libs
The challange is the ALPN and NPN support and all our different SSL
backends. Right now we support ALPN and VPN with OpenSSL and ALPN with
GnuTLS.
Applications
We hide http2's binary nature and convert received http2 traffic to headers
in HTTP 1.1 style. This allows applications to work unmodified.
curl tool
curl offers the --http2 command line option to enable use of http2
To consider: To consider: