walkero
/
nghttp2
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity

Update README.rst

This commit is contained in:
Tatsuhiro Tsujikawa 2013-08-23 03:45:55 +09:00
parent 93e5b9e562
commit c4f6e069ac
1 changed files with 70 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

135
README.rst
View File

@ -7,10 +7,12 @@ version 2.0.
Development Status Development Status
------------------ ------------------
We started to implement HTTP-draft-04/2.0 We started to implement HTTP-draft-06/2.0
(http://tools.ietf.org/html/draft-ietf-httpbis-http2-04) based on (http://tools.ietf.org/html/draft-ietf-httpbis-http2-06) and the
spdylay code base. The header compression is based on header compression
http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-01 (http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-02).
The nghttp2 code base was forked from spdylay project.
=================== ================= =================== =================
Features HTTP-draft-04/2.0 Features HTTP-draft-04/2.0
@ -127,33 +129,34 @@ with prior knowledge, HTTP Upgrade and NPN TLS extension.
It has verbose output mode for framing information. Here is sample It has verbose output mode for framing information. Here is sample
output from ``nghttp`` client:: output from ``nghttp`` client::
$ src/nghttp -nv https://localhost:3000/ $ src/nghttp -vn https://localhost:8443
[ 0.000] NPN select next protocol: the remote server offers: [ 0.001] NPN select next protocol: the remote server offers:
* HTTP-draft-04/2.0 * HTTP-draft-06/2.0
* spdy/3 * spdy/3
* spdy/2 * spdy/2
* http/1.1 * http/1.1
NPN selected the protocol: HTTP-draft-04/2.0 NPN selected the protocol: HTTP-draft-06/2.0
[ 0.005] send SETTINGS frame <length=0, flags=0, stream_id=0> [ 0.006] send SETTINGS frame <length=16, flags=0x00, stream_id=0>
(niv=0) (niv=2)
[ 0.005] send HEADERS frame <length=58, flags=5, stream_id=1> [MAX_CONCURRENT_STREAMS(4):100]
[INITIAL_WINDOW_SIZE(7):65535]
[ 0.006] send HEADERS frame <length=58, flags=0x05, stream_id=1>
; END_STREAM | END_HEADERS ; END_STREAM | END_HEADERS
; Open new stream ; Open new stream
:host: localhost:3000 :host: localhost:8443
:method: GET :method: GET
:path: / :path: /
:scheme: https :scheme: https
accept: */* accept: */*
accept-encoding: gzip, deflate accept-encoding: gzip, deflate
user-agent: nghttp2/0.1.0-DEV user-agent: nghttp2/0.1.0-DEV
[ 0.005] recv SETTINGS frame <length=16, flags=0, stream_id=0> [ 0.007] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
(niv=2) (niv=2)
[4:100] [MAX_CONCURRENT_STREAMS(4):100]
[7:65536] [INITIAL_WINDOW_SIZE(7):65535]
[ 0.005] recv WINDOW_UPDATE frame <length=4, flags=1, stream_id=0> [ 0.008] recv WINDOW_UPDATE frame <length=4, flags=0x00, stream_id=0>
; END_FLOW_CONTROL (window_size_increment=1000000007)
(window_size_increment=0) [ 0.008] recv HEADERS frame <length=179, flags=0x04, stream_id=1>
[ 0.006] recv HEADERS frame <length=179, flags=4, stream_id=1>
; END_HEADERS ; END_HEADERS
; First response header ; First response header
:status: 200 OK :status: 200 OK
@ -161,66 +164,67 @@ output from ``nghttp`` client::
content-encoding: gzip content-encoding: gzip
content-length: 56 content-length: 56
content-type: text/html content-type: text/html
date: Sat, 27 Jul 2013 12:08:56 GMT date: Thu, 22 Aug 2013 16:37:17 GMT
etag: "cf405c-2d-45adabdf282c0" etag: "cf405c-2d-45adabdf282c0"
last-modified: Tue, 04 Nov 2008 10:44:03 GMT last-modified: Tue, 04 Nov 2008 10:44:03 GMT
server: Apache/2.2.22 (Debian) server: Apache/2.2.22 (Debian)
vary: Accept-Encoding vary: Accept-Encoding
via: 1.1 nghttpx via: 1.1 nghttpx
[ 0.006] recv DATA frame (length=56, flags=0, stream_id=1) [ 0.009] recv DATA frame <length=56, flags=0x00, stream_id=1>
[ 0.006] recv DATA frame (length=0, flags=1, stream_id=1) [ 0.009] recv DATA frame <length=0, flags=0x01, stream_id=1>
[ 0.006] send GOAWAY frame <length=8, flags=0, stream_id=0> ; END_STREAM
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data=) [ 0.009] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
The HTTP Upgrade is performed like this:: The HTTP Upgrade is performed like this::
$ src/nghttp --no-tls -nvu http://localhost:3000/ $ src/nghttp -vnu http://localhost:8080
[ 0.000] HTTP Upgrade request [ 0.000] HTTP Upgrade request
GET / HTTP/1.1 GET / HTTP/1.1
Host: localhost:3000 Host: localhost:8080
Connection: Upgrade, HTTP2-Settings Connection: Upgrade, HTTP2-Settings
Upgrade: HTTP-draft-04/2.0 Upgrade: HTTP-draft-06/2.0
HTTP2-Settings: AAAABAAAAGQAAAAHAAD__w HTTP2-Settings: AAAABAAAAGQAAAAHAAD__w
Accept: */* Accept: */*
User-Agent: nghttp2/0.1.0-DEV User-Agent: nghttp2/0.1.0-DEV
[ 0.183] HTTP Upgrade response [ 0.000] HTTP Upgrade response
HTTP/1.1 101 Switching Protocols HTTP/1.1 101 Switching Protocols
Connection: Upgrade Connection: Upgrade
Upgrade: HTTP/2.0 Upgrade: HTTP/2.0
[ 0.183] HTTP Upgrade success [ 0.000] HTTP Upgrade success
[ 0.183] send SETTINGS frame <length=16, flags=0x00, stream_id=0> [ 0.001] send SETTINGS frame <length=16, flags=0x00, stream_id=0>
(niv=2) (niv=2)
[4:100] [MAX_CONCURRENT_STREAMS(4):100]
[7:65535] [INITIAL_WINDOW_SIZE(7):65535]
[ 0.202] recv SETTINGS frame <length=16, flags=0x00, stream_id=0> [ 0.001] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
(niv=2) (niv=2)
[4:100] [MAX_CONCURRENT_STREAMS(4):100]
[7:65536] [INITIAL_WINDOW_SIZE(7):65535]
[ 0.202] recv WINDOW_UPDATE frame <length=4, flags=0x01, stream_id=0> [ 0.001] recv WINDOW_UPDATE frame <length=4, flags=0x00, stream_id=0>
; END_FLOW_CONTROL (window_size_increment=1000000007)
(window_size_increment=0) [ 0.001] recv HEADERS frame <length=198, flags=0x04, stream_id=1>
[ 0.275] recv HEADERS frame <length=198, flags=0x04, stream_id=1>
; END_HEADERS ; END_HEADERS
; First response header ; First response header
:status: 200 OK :status: 200 OK
accept-ranges: bytes accept-ranges: bytes
content-length: 45 content-length: 45
content-type: text/html content-type: text/html
date: Sat, 03 Aug 2013 10:21:20 GMT date: Thu, 22 Aug 2013 16:39:04 GMT
etag: "cf405c-2d-45adabdf282c0" etag: "cf405c-2d-45adabdf282c0"
last-modified: Tue, 04 Nov 2008 10:44:03 GMT last-modified: Tue, 04 Nov 2008 10:44:03 GMT
server: Apache/2.2.22 (Debian) server: Apache/2.2.22 (Debian)
vary: Accept-Encoding vary: Accept-Encoding
via: 1.1 nghttpx via: 1.1 nghttpx
x-pad: avoid browser bug x-pad: avoid browser bug
[ 0.275] recv DATA frame (length=45, flags=0, stream_id=1) [ 0.001] recv DATA frame <length=45, flags=0x00, stream_id=1>
[ 0.275] recv DATA frame (length=0, flags=1, stream_id=1) [ 0.001] recv DATA frame <length=0, flags=0x01, stream_id=1>
[ 0.275] send GOAWAY frame <length=8, flags=0x00, stream_id=0> ; END_STREAM
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data=) [ 0.001] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
nghttpd - server nghttpd - server
++++++++++++++++ ++++++++++++++++
@ -237,46 +241,47 @@ HTTP/2.0 connection. No HTTP Upgrade is supported.
Just like ``nghttp``, it has verbose output mode for framing Just like ``nghttp``, it has verbose output mode for framing
information. Here is sample output from ``nghttpd`` server:: information. Here is sample output from ``nghttpd`` server::
$ src/nghttpd 3000 --no-tls -v $ src/nghttpd --no-tls -v 8080
IPv4: listen on port 3000 IPv4: listen on port 8080
IPv6: listen on port 3000 IPv6: listen on port 8080
[id=1] [ 1.020] send SETTINGS frame <length=8, flags=0, stream_id=0> [id=1] [ 14.716] send SETTINGS frame <length=8, flags=0x00, stream_id=0>
(niv=1) (niv=1)
[4:100] [MAX_CONCURRENT_STREAMS(4):100]
[id=1] [ 1.020] closed [id=1] [ 14.717] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
[id=2] [ 1.838] send SETTINGS frame <length=8, flags=0, stream_id=0> (niv=2)
(niv=1) [MAX_CONCURRENT_STREAMS(4):100]
[4:100] [INITIAL_WINDOW_SIZE(7):65535]
[id=2] [ 1.838] recv SETTINGS frame <length=0, flags=0, stream_id=0> [id=1] [ 14.717] recv HEADERS frame <length=58, flags=0x05, stream_id=1>
(niv=0)
[id=2] [ 1.838] recv HEADERS frame <length=58, flags=5, stream_id=1>
; END_STREAM | END_HEADERS ; END_STREAM | END_HEADERS
; Open new stream ; Open new stream
:host: localhost:3000 :host: localhost:8080
:method: GET :method: GET
:path: / :path: /
:scheme: http :scheme: http
accept: */* accept: */*
accept-encoding: gzip, deflate accept-encoding: gzip, deflate
user-agent: nghttp2/0.1.0-DEV user-agent: nghttp2/0.1.0-DEV
[id=2] [ 1.838] send HEADERS frame <length=105, flags=4, stream_id=1> [id=1] [ 14.717] send HEADERS frame <length=105, flags=0x04, stream_id=1>
; END_HEADERS ; END_HEADERS
; First response header ; First response header
:status: 404 Not Found :status: 404 Not Found
content-encoding: gzip content-encoding: gzip
content-type: text/html; charset=UTF-8 content-type: text/html; charset=UTF-8
date: Sat, 27 Jul 2013 12:32:10 GMT date: Thu, 22 Aug 2013 16:41:05 GMT
server: nghttpd nghttp2/0.1.0-DEV server: nghttpd nghttp2/0.1.0-DEV
[id=2] [ 1.838] send DATA frame (length=127, flags=0, stream_id=1) [id=1] [ 14.717] send DATA frame <length=128, flags=0x00, stream_id=1>
[id=2] [ 1.838] send DATA frame (length=0, flags=1, stream_id=1) [id=1] [ 14.717] send DATA frame <length=0, flags=0x01, stream_id=1>
[id=2] [ 1.838] stream_id=1 closed ; END_STREAM
[id=2] [ 1.839] closed [id=1] [ 14.717] stream_id=1 closed
[id=1] [ 14.717] recv GOAWAY frame <length=8, flags=0x00, stream_id=0>
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
[id=1] [ 14.717] closed
nghttpx - proxy nghttpx - proxy
+++++++++++++++ +++++++++++++++
The ``nghttpx`` is a multi-threaded reverse proxy for The ``nghttpx`` is a multi-threaded reverse proxy for
HTTP-draft-04/2.0, SPDY and HTTP/1.1. It has several operation modes: HTTP-draft-06/2.0, SPDY and HTTP/1.1. It has several operation modes:
================== ============================== ============== ============= ================== ============================== ============== =============
Mode option Frontend Backend Note Mode option Frontend Backend Note
@ -289,7 +294,7 @@ default mode HTTP/2.0, SPDY, HTTP/1.1 (TLS) HTTP/1.1 Reverse proxy
================== ============================== ============== ============= ================== ============================== ============== =============
The interesting mode at the moment is the default mode. It works like The interesting mode at the moment is the default mode. It works like
a reverse proxy and listens HTTP-draft-04/2.0, SPDY and HTTP/1.1 and a reverse proxy and listens HTTP-draft-06/2.0, SPDY and HTTP/1.1 and
can be deployed SSL/TLS terminator for existing web server. can be deployed SSL/TLS terminator for existing web server.
The default mode, ``--spdy`` and ``--spdy-bridge`` modes use SSL/TLS The default mode, ``--spdy`` and ``--spdy-bridge`` modes use SSL/TLS