Commit 6444f0c5 authored by Tatsuhiro Tsujikawa's avatar Tatsuhiro Tsujikawa

Update man pages

parent 1e74ee2d
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "H2LOAD" "1" "November 12, 2015" "1.4.1-DEV" "nghttp2" .TH "H2LOAD" "1" "November 26, 2015" "1.5.0" "nghttp2"
.SH NAME .SH NAME
h2load \- HTTP/2 benchmarking tool h2load \- HTTP/2 benchmarking tool
. .
...@@ -227,6 +227,13 @@ Default: \fBh2,h2\-16,h2\-14,spdy/3.1,spdy/3,spdy/2,http/1.1\fP ...@@ -227,6 +227,13 @@ Default: \fBh2,h2\-16,h2\-14,spdy/3.1,spdy/3,spdy/2,http/1.1\fP
.UNINDENT .UNINDENT
.INDENT 0.0 .INDENT 0.0
.TP .TP
.B \-\-h1
Short hand for \fI\%\-\-npn\-list\fP=http/1.1
\fI\%\-\-no\-tls\-proto\fP=http/1.1, which effectively force
http/1.1 for both http and https URI.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-verbose .B \-v, \-\-verbose
Output debug information. Output debug information.
.UNINDENT .UNINDENT
......
...@@ -188,6 +188,12 @@ OPTIONS ...@@ -188,6 +188,12 @@ OPTIONS
Default: ``h2,h2-16,h2-14,spdy/3.1,spdy/3,spdy/2,http/1.1`` Default: ``h2,h2-16,h2-14,spdy/3.1,spdy/3,spdy/2,http/1.1``
.. option:: --h1
Short hand for :option:`--npn-list`\=http/1.1
:option:`--no-tls-proto`\=http/1.1, which effectively force
http/1.1 for both http and https URI.
.. option:: -v, --verbose .. option:: -v, --verbose
Output debug information. Output debug information.
......
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "NGHTTP" "1" "November 12, 2015" "1.4.1-DEV" "nghttp2" .TH "NGHTTP" "1" "November 26, 2015" "1.5.0" "nghttp2"
.SH NAME .SH NAME
nghttp \- HTTP/2 client nghttp \- HTTP/2 client
. .
......
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "NGHTTPD" "1" "November 12, 2015" "1.4.1-DEV" "nghttp2" .TH "NGHTTPD" "1" "November 26, 2015" "1.5.0" "nghttp2"
.SH NAME .SH NAME
nghttpd \- HTTP/2 server nghttpd \- HTTP/2 server
. .
......
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "NGHTTPX" "1" "November 12, 2015" "1.4.1-DEV" "nghttp2" .TH "NGHTTPX" "1" "November 26, 2015" "1.5.0" "nghttp2"
.SH NAME .SH NAME
nghttpx \- HTTP/2 proxy nghttpx \- HTTP/2 proxy
. .
...@@ -685,9 +685,14 @@ protocol security. ...@@ -685,9 +685,14 @@ protocol security.
.INDENT 0.0 .INDENT 0.0
.TP .TP
.B \-\-no\-server\-push .B \-\-no\-server\-push
Disable HTTP/2 server push. Server push is only Disable HTTP/2 server push. Server push is supported by
supported by default mode and HTTP/2 frontend. SPDY default mode and HTTP/2 frontend via Link header field.
frontend does not support server push. It is also supported if both frontend and backend are
HTTP/2 (which implies \fI\%\-\-http2\-bridge\fP or \fI\%\-\-client\fP mode).
In this case, server push from backend session is
relayed to frontend, and server push via Link header
field is also supported. HTTP SPDY frontend does not
support server push.
.UNINDENT .UNINDENT
.SS Mode .SS Mode
.INDENT 0.0 .INDENT 0.0
...@@ -1053,8 +1058,8 @@ than master process. ...@@ -1053,8 +1058,8 @@ than master process.
.UNINDENT .UNINDENT
.SH SERVER PUSH .SH SERVER PUSH
.sp .sp
nghttpx supports HTTP/2 server push in default mode. nghttpx looks nghttpx supports HTTP/2 server push in default mode with Link header
for Link header field (\fI\%RFC 5988\fP) in response headers from field. nghttpx looks for Link header field (\fI\%RFC 5988\fP) in response headers from
backend server and extracts URI\-reference with parameter backend server and extracts URI\-reference with parameter
\fBrel=preload\fP (see \fI\%preload\fP) \fBrel=preload\fP (see \fI\%preload\fP)
and pushes those URIs to the frontend client. Here is a sample Link and pushes those URIs to the frontend client. Here is a sample Link
...@@ -1079,6 +1084,14 @@ associated stream\(aqs status code must be 200. ...@@ -1079,6 +1084,14 @@ associated stream\(aqs status code must be 200.
.UNINDENT .UNINDENT
.sp .sp
This limitation may be loosened in the future release. This limitation may be loosened in the future release.
.sp
nghttpx also supports server push if both frontend and backend are
HTTP/2 (which implies \fI\%\-\-http2\-bridge\fP or \fI\%\-\-client\fP).
In this case, in addition to server push via Link header field, server
push from backend is relayed to frontend HTTP/2 session.
.sp
HTTP/2 server push will be disabled if \fI\%\-\-http2\-proxy\fP or
\fI\%\-\-client\-proxy\fP is used.
.SH UNIX DOMAIN SOCKET .SH UNIX DOMAIN SOCKET
.sp .sp
nghttpx supports UNIX domain socket with a filename for both frontend nghttpx supports UNIX domain socket with a filename for both frontend
......
...@@ -613,9 +613,14 @@ HTTP/2 and SPDY ...@@ -613,9 +613,14 @@ HTTP/2 and SPDY
.. option:: --no-server-push .. option:: --no-server-push
Disable HTTP/2 server push. Server push is only Disable HTTP/2 server push. Server push is supported by
supported by default mode and HTTP/2 frontend. SPDY default mode and HTTP/2 frontend via Link header field.
frontend does not support server push. It is also supported if both frontend and backend are
HTTP/2 (which implies :option:`--http2-bridge` or :option:`\--client` mode).
In this case, server push from backend session is
relayed to frontend, and server push via Link header
field is also supported. HTTP SPDY frontend does not
support server push.
Mode Mode
...@@ -954,8 +959,8 @@ SIGUSR2 ...@@ -954,8 +959,8 @@ SIGUSR2
SERVER PUSH SERVER PUSH
----------- -----------
nghttpx supports HTTP/2 server push in default mode. nghttpx looks nghttpx supports HTTP/2 server push in default mode with Link header
for Link header field (`RFC 5988 field. nghttpx looks for Link header field (`RFC 5988
<http://tools.ietf.org/html/rfc5988>`_) in response headers from <http://tools.ietf.org/html/rfc5988>`_) in response headers from
backend server and extracts URI-reference with parameter backend server and extracts URI-reference with parameter
``rel=preload`` (see `preload ``rel=preload`` (see `preload
...@@ -975,6 +980,14 @@ Currently, the following restriction is applied for server push: ...@@ -975,6 +980,14 @@ Currently, the following restriction is applied for server push:
This limitation may be loosened in the future release. This limitation may be loosened in the future release.
nghttpx also supports server push if both frontend and backend are
HTTP/2 (which implies :option:`--http2-bridge` or :option:`--client`).
In this case, in addition to server push via Link header field, server
push from backend is relayed to frontend HTTP/2 session.
HTTP/2 server push will be disabled if :option:`--http2-proxy` or
:option:`--client-proxy` is used.
UNIX DOMAIN SOCKET UNIX DOMAIN SOCKET
------------------ ------------------
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment