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 2014-02-15 17:19:49 +09:00
parent 0da79865b8
commit 652dc250fd
1 changed files with 104 additions and 102 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

206
README.rst
View File

@ -7,25 +7,22 @@ version 2.0.
Development Status Development Status
------------------ ------------------
We started to implement HTTP-draft-09/2.0 We started to implement HTTP-draft-10/2.0
(http://tools.ietf.org/html/draft-ietf-httpbis-http2-09) and the (http://tools.ietf.org/html/draft-ietf-httpbis-http2-10) and the
header compression header compression
(http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-05). (http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-06).
The nghttp2 code base was forked from spdylay project. The nghttp2 code base was forked from spdylay project.
========================== ================= ========================== =====
Features HTTP-draft-09/2.0 Features h2-10
========================== ================= ========================== =====
:authority Done HPACK-draft-06 Done
HPACK-draft-05 Done Strict SETTINGS validation Done
SETTINGS_HEADER_TABLE_SIZE Done Disallow client to push Done
SETTINGS_ENABLE_PUSH Done Padding Done
FRAME_SIZE_ERROR Done END_SEGMENT
SETTINGS with ACK Done ========================== =====
Header Continuation Done
ALPN Done
========================== =================
Public Test Server Public Test Server
------------------ ------------------
@ -150,19 +147,21 @@ with prior knowledge, HTTP Upgrade and NPN/ALPN 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 -vn https://localhost:8443 $ src/nghttp -nv https://localhost:8443
[ 0.003] NPN select next protocol: the remote server offers: [ 0.004][NPN] server offers:
* HTTP-draft-09/2.0 * h2-10
* spdy/3.1
* spdy/3 * spdy/3
* spdy/2 * spdy/2
* http/1.1 * http/1.1
NPN selected the protocol: HTTP-draft-09/2.0 The negotiated protocol: h2-10
[ 0.005] send SETTINGS frame <length=16, flags=0x00, stream_id=0> [ 0.006] send SETTINGS frame <length=10, flags=0x00, stream_id=0>
(niv=2) (niv=2)
[SETTINGS_MAX_CONCURRENT_STREAMS(4):100] [SETTINGS_MAX_CONCURRENT_STREAMS(3):100]
[SETTINGS_INITIAL_WINDOW_SIZE(7):65535] [SETTINGS_INITIAL_WINDOW_SIZE(4):65535]
[ 0.006] send HEADERS frame <length=47, flags=0x05, stream_id=1> [ 0.007] send HEADERS frame <length=48, flags=0x05, stream_id=1>
; END_STREAM | END_HEADERS ; END_STREAM | END_HEADERS
(padlen=0)
; Open new stream ; Open new stream
:authority: localhost:8443 :authority: localhost:8443
:method: GET :method: GET
@ -170,91 +169,91 @@ output from ``nghttp`` client::
: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.4.0-DEV
[ 0.006] recv SETTINGS frame <length=16, flags=0x00, stream_id=0> [ 0.007] recv SETTINGS frame <length=15, flags=0x00, stream_id=0>
(niv=2) (niv=3)
[SETTINGS_MAX_CONCURRENT_STREAMS(4):100] [SETTINGS_MAX_CONCURRENT_STREAMS(3):100]
[SETTINGS_INITIAL_WINDOW_SIZE(7):65535] [SETTINGS_INITIAL_WINDOW_SIZE(4):65535]
[ 0.006] send SETTINGS frame <length=0, flags=0x01, stream_id=0> [SETTINGS_ENABLE_PUSH(2):0]
[ 0.007] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
; ACK ; ACK
(niv=0) (niv=0)
[ 0.006] recv WINDOW_UPDATE frame <length=4, flags=0x00, stream_id=0> [ 0.007] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
(window_size_increment=1000000007)
[ 0.006] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
; ACK ; ACK
(niv=0) (niv=0)
[ 0.006] recv HEADERS frame <length=132, flags=0x04, stream_id=1> [ 0.008] (stream_id=1) :status: 200
[ 0.008] (stream_id=1) accept-ranges: bytes
[ 0.008] (stream_id=1) content-encoding: gzip
[ 0.008] (stream_id=1) content-length: 146
[ 0.008] (stream_id=1) content-type: text/html
[ 0.008] (stream_id=1) date: Sat, 15 Feb 2014 08:14:12 GMT
[ 0.008] (stream_id=1) etag: "b1-4e5535a027780-gzip"
[ 0.008] (stream_id=1) last-modified: Sun, 01 Sep 2013 14:34:22 GMT
[ 0.008] (stream_id=1) server: Apache/2.4.6 (Debian)
[ 0.008] (stream_id=1) vary: Accept-Encoding
[ 0.008] (stream_id=1) via: 1.1 nghttpx
[ 0.008] recv HEADERS frame <length=141, flags=0x04, stream_id=1>
; END_HEADERS ; END_HEADERS
(padlen=0)
; First response header ; First response header
:status: 200 [ 0.008] recv DATA frame <length=146, flags=0x00, stream_id=1>
accept-ranges: bytes [ 0.008] recv DATA frame <length=0, flags=0x01, stream_id=1>
content-encoding: gzip
content-length: 146
content-type: text/html
date: Sun, 27 Oct 2013 14:23:54 GMT
etag: "b1-4e5535a027780-gzip"
last-modified: Sun, 01 Sep 2013 14:34:22 GMT
server: Apache/2.4.6 (Debian)
vary: Accept-Encoding
via: 1.1 nghttpx
[ 0.006] recv DATA frame <length=146, flags=0x00, stream_id=1>
[ 0.006] recv DATA frame <length=0, flags=0x01, stream_id=1>
; END_STREAM ; END_STREAM
[ 0.007] send GOAWAY frame <length=8, flags=0x00, stream_id=0> [ 0.008] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data(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 -vnu http://localhost:8080 $ src/nghttp -nvu http://localhost:8080
[ 0.000] HTTP Upgrade request [ 0.000] HTTP Upgrade request
GET / HTTP/1.1 GET / HTTP/1.1
Host: localhost:8080 Host: localhost:8080
Connection: Upgrade, HTTP2-Settings Connection: Upgrade, HTTP2-Settings
Upgrade: HTTP-draft-09/2.0 Upgrade: h2-10
HTTP2-Settings: AAAABAAAAGQAAAAHAAD__w HTTP2-Settings: AwAAAGQEAAD__w
Accept: */* Accept: */*
User-Agent: nghttp2/0.1.0-DEV User-Agent: nghttp2/0.4.0-DEV
[ 0.000] HTTP Upgrade response [ 0.001] HTTP Upgrade response
HTTP/1.1 101 Switching Protocols HTTP/1.1 101 Switching Protocols
Connection: Upgrade Connection: Upgrade
Upgrade: HTTP-draft-09/2.0 Upgrade: h2-10
[ 0.001] HTTP Upgrade success [ 0.001] HTTP Upgrade success
[ 0.001] send SETTINGS frame <length=16, flags=0x00, stream_id=0> [ 0.001] send SETTINGS frame <length=10, flags=0x00, stream_id=0>
(niv=2) (niv=2)
[SETTINGS_MAX_CONCURRENT_STREAMS(4):100] [SETTINGS_MAX_CONCURRENT_STREAMS(3):100]
[SETTINGS_INITIAL_WINDOW_SIZE(7):65535] [SETTINGS_INITIAL_WINDOW_SIZE(4):65535]
[ 0.001] recv SETTINGS frame <length=16, flags=0x00, stream_id=0> [ 0.001] recv SETTINGS frame <length=15, flags=0x00, stream_id=0>
(niv=2) (niv=3)
[SETTINGS_MAX_CONCURRENT_STREAMS(4):100] [SETTINGS_MAX_CONCURRENT_STREAMS(3):100]
[SETTINGS_INITIAL_WINDOW_SIZE(7):65535] [SETTINGS_INITIAL_WINDOW_SIZE(4):65535]
[ 0.001] recv WINDOW_UPDATE frame <length=4, flags=0x00, stream_id=0> [SETTINGS_ENABLE_PUSH(2):0]
(window_size_increment=1000000007) [ 0.001] (stream_id=1) :status: 200
[ 0.001] recv HEADERS frame <length=121, flags=0x04, stream_id=1> [ 0.001] (stream_id=1) accept-ranges: bytes
[ 0.001] (stream_id=1) content-length: 177
[ 0.001] (stream_id=1) content-type: text/html
[ 0.001] (stream_id=1) date: Sat, 15 Feb 2014 08:16:23 GMT
[ 0.001] (stream_id=1) etag: "b1-4e5535a027780"
[ 0.001] (stream_id=1) last-modified: Sun, 01 Sep 2013 14:34:22 GMT
[ 0.001] (stream_id=1) server: Apache/2.4.6 (Debian)
[ 0.001] (stream_id=1) vary: Accept-Encoding
[ 0.001] (stream_id=1) via: 1.1 nghttpx
[ 0.001] recv HEADERS frame <length=132, flags=0x04, stream_id=1>
; END_HEADERS ; END_HEADERS
(padlen=0)
; First response header ; First response header
:status: 200
accept-ranges: bytes
content-length: 177
content-type: text/html
date: Sun, 27 Oct 2013 14:26:04 GMT
etag: "b1-4e5535a027780"
last-modified: Sun, 01 Sep 2013 14:34:22 GMT
server: Apache/2.4.6 (Debian)
vary: Accept-Encoding
via: 1.1 nghttpx
[ 0.001] recv DATA frame <length=177, flags=0x00, stream_id=1> [ 0.001] recv DATA frame <length=177, flags=0x00, stream_id=1>
[ 0.001] recv DATA frame <length=0, flags=0x01, stream_id=1> [ 0.001] recv DATA frame <length=0, flags=0x01, stream_id=1>
; END_STREAM ; END_STREAM
[ 0.001] send SETTINGS frame <length=0, flags=0x01, stream_id=0> [ 0.002] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
; ACK ; ACK
(niv=0) (niv=0)
[ 0.001] send GOAWAY frame <length=8, flags=0x00, stream_id=0> [ 0.002] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[]) (last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
[ 0.001] recv SETTINGS frame <length=0, flags=0x01, stream_id=0> [ 0.002] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
; ACK ; ACK
(niv=0) (niv=0)
@ -278,50 +277,53 @@ information. Here is sample output from ``nghttpd`` server::
$ src/nghttpd --no-tls -v 8080 $ src/nghttpd --no-tls -v 8080
IPv4: listen on port 8080 IPv4: listen on port 8080
IPv6: listen on port 8080 IPv6: listen on port 8080
[id=1] [ 1.189] send SETTINGS frame <length=8, flags=0x00, stream_id=0> [id=1] [ 1.027] send SETTINGS frame <length=10, flags=0x00, stream_id=0>
(niv=1)
[SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
[id=1] [ 1.191] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
(niv=2) (niv=2)
[SETTINGS_MAX_CONCURRENT_STREAMS(4):100] [SETTINGS_MAX_CONCURRENT_STREAMS(3):100]
[SETTINGS_INITIAL_WINDOW_SIZE(7):65535] [SETTINGS_ENABLE_PUSH(2):0]
[id=1] [ 1.191] recv HEADERS frame <length=47, flags=0x05, stream_id=1> [id=1] [ 1.027] recv SETTINGS frame <length=10, flags=0x00, stream_id=0>
(niv=2)
[SETTINGS_MAX_CONCURRENT_STREAMS(3):100]
[SETTINGS_INITIAL_WINDOW_SIZE(4):65535]
[id=1] [ 1.027] (stream_id=1) :authority: localhost:8080
[id=1] [ 1.027] (stream_id=1) :method: GET
[id=1] [ 1.027] (stream_id=1) :path: /
[id=1] [ 1.027] (stream_id=1) :scheme: http
[id=1] [ 1.027] (stream_id=1) accept: */*
[id=1] [ 1.027] (stream_id=1) accept-encoding: gzip, deflate
[id=1] [ 1.027] (stream_id=1) user-agent: nghttp2/0.4.0-DEV
[id=1] [ 1.027] recv HEADERS frame <length=48, flags=0x05, stream_id=1>
; END_STREAM | END_HEADERS ; END_STREAM | END_HEADERS
(padlen=0)
; Open new stream ; Open new stream
:authority: localhost:8080 [id=1] [ 1.027] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
:method: GET
:path: /
:scheme: http
accept: */*
accept-encoding: gzip, deflate
user-agent: nghttp2/0.1.0-DEV
[id=1] [ 1.192] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
; ACK ; ACK
(niv=0) (niv=0)
[id=1] [ 1.192] send HEADERS frame <length=70, flags=0x04, stream_id=1> [id=1] [ 1.027] send HEADERS frame <length=72, flags=0x04, stream_id=1>
; END_HEADERS ; END_HEADERS
(padlen=0)
; First response header ; First response header
:status: 404 :status: 404
content-encoding: gzip content-encoding: gzip
content-type: text/html; charset=UTF-8 content-type: text/html; charset=UTF-8
date: Sun, 27 Oct 2013 14:27:53 GMT date: Sat, 15 Feb 2014 08:18:53 GMT
server: nghttpd nghttp2/0.1.0-DEV server: nghttpd nghttp2/0.4.0-DEV
[id=1] [ 1.192] send DATA frame <length=117, flags=0x00, stream_id=1> [id=1] [ 1.028] send DATA frame <length=118, flags=0x00, stream_id=1>
[id=1] [ 1.192] send DATA frame <length=0, flags=0x01, stream_id=1> [id=1] [ 1.028] send DATA frame <length=0, flags=0x01, stream_id=1>
; END_STREAM ; END_STREAM
[id=1] [ 1.192] stream_id=1 closed [id=1] [ 1.028] stream_id=1 closed
[id=1] [ 1.192] recv SETTINGS frame <length=0, flags=0x01, stream_id=0> [id=1] [ 1.028] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
; ACK ; ACK
(niv=0) (niv=0)
[id=1] [ 1.192] recv GOAWAY frame <length=8, flags=0x00, stream_id=0> [id=1] [ 1.028] recv GOAWAY frame <length=8, flags=0x00, stream_id=0>
(last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[]) (last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
[id=1] [ 1.192] closed [id=1] [ 1.028] 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-09/2.0, SPDY and HTTP/1.1. It has several operation modes: h2-10, SPDY and HTTP/1.1. It has several operation modes:
================== ============================== ============== ============= ================== ============================== ============== =============
Mode option Frontend Backend Note Mode option Frontend Backend Note
@ -334,7 +336,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-09/2.0, SPDY and HTTP/1.1 and a reverse proxy and listens h2-10, 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, ``--http2-proxy`` and ``--http2-bridge`` modes use The default mode, ``--http2-proxy`` and ``--http2-bridge`` modes use