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

Update manual pages

This commit is contained in:
Tatsuhiro Tsujikawa 2017-04-19 23:03:08 +09:00
parent 17614312e0
commit 34d3c45d35
5 changed files with 45 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/h2load.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "H2LOAD" "1" "Apr 09, 2017" "1.22.0-DEV" "nghttp2" .TH "H2LOAD" "1" "Apr 19, 2017" "1.22.0-DEV" "nghttp2"
.SH NAME .SH NAME
h2load \- HTTP/2 benchmarking tool h2load \- HTTP/2 benchmarking tool
. .

2
doc/nghttp.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "NGHTTP" "1" "Apr 09, 2017" "1.22.0-DEV" "nghttp2" .TH "NGHTTP" "1" "Apr 19, 2017" "1.22.0-DEV" "nghttp2"
.SH NAME .SH NAME
nghttp \- HTTP/2 client nghttp \- HTTP/2 client
. .

2
doc/nghttpd.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "NGHTTPD" "1" "Apr 09, 2017" "1.22.0-DEV" "nghttp2" .TH "NGHTTPD" "1" "Apr 19, 2017" "1.22.0-DEV" "nghttp2"
.SH NAME .SH NAME
nghttpd \- HTTP/2 server nghttpd \- HTTP/2 server
. .

35
doc/nghttpx.1
View File

@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText. .\" Man page generated from reStructuredText.
. .
.TH "NGHTTPX" "1" "Apr 09, 2017" "1.22.0-DEV" "nghttp2" .TH "NGHTTPX" "1" "Apr 19, 2017" "1.22.0-DEV" "nghttp2"
.SH NAME .SH NAME
nghttpx \- HTTP/2 proxy nghttpx \- HTTP/2 proxy
. .
@ -73,14 +73,16 @@ path which ends with "\fI/\fP" also matches the request path
which only lacks trailing \(aq\fI/\fP\(aq (e.g., path "\fI/foo/\fP" which only lacks trailing \(aq\fI/\fP\(aq (e.g., path "\fI/foo/\fP"
matches request path "\fI/foo\fP"). If it does not end with matches request path "\fI/foo\fP"). If it does not end with
"\fI/\fP", it performs exact match against the request path. "\fI/\fP", it performs exact match against the request path.
If host is given, it performs exact match against the If host is given, it performs a match against the
request host. If host alone is given, "\fI/\fP" is appended request host. For a request received on the frontend
to it, so that it matches all request paths under the lister with "sni\-fwd" parameter enabled, SNI host is
host (e.g., specifying "nghttp2.org" equals to used instead of a request host. If host alone is given,
"nghttp2.org/"). CONNECT method is treated specially. "\fI/\fP" is appended to it, so that it matches all request
It does not have path, and we don\(aqt allow empty path. paths under the host (e.g., specifying "nghttp2.org"
To workaround this, we assume that CONNECT method has equals to "nghttp2.org/"). CONNECT method is treated
"\fI/\fP" as path. specially. It does not have path, and we don\(aqt allow
empty path. To workaround this, we assume that CONNECT
method has "\fI/\fP" as path.
.sp .sp
Patterns with host take precedence over patterns with Patterns with host take precedence over patterns with
just path. Then, longer patterns take precedence over just path. Then, longer patterns take precedence over
@ -221,6 +223,11 @@ parameters are mutually exclusive.
Optionally, TLS can be disabled by specifying "no\-tls" Optionally, TLS can be disabled by specifying "no\-tls"
parameter. TLS is enabled by default. parameter. TLS is enabled by default.
.sp .sp
If "sni\-fwd" parameter is used, when performing a match
to select a backend server, SNI host name received from
the client is used instead of the request host. See
\fI\%\-\-backend\fP option about the pattern match.
.sp
To make this frontend as API endpoint, specify "api" To make this frontend as API endpoint, specify "api"
parameter. This is disabled by default. It is parameter. This is disabled by default. It is
important to limit the access to the API frontend. important to limit the access to the API frontend.
@ -1142,15 +1149,17 @@ $alpn: ALPN identifier of the protocol which generates
the response. For HTTP/1, ALPN is always http/1.1, the response. For HTTP/1, ALPN is always http/1.1,
regardless of minor version. regardless of minor version.
.IP \(bu 2 .IP \(bu 2
$ssl_cipher: cipher used for SSL/TLS connection. $tls_cipher: cipher used for SSL/TLS connection.
.IP \(bu 2 .IP \(bu 2
$ssl_protocol: protocol for SSL/TLS connection. $tls_protocol: protocol for SSL/TLS connection.
.IP \(bu 2 .IP \(bu 2
$ssl_session_id: session ID for SSL/TLS connection. $tls_session_id: session ID for SSL/TLS connection.
.IP \(bu 2 .IP \(bu 2
$ssl_session_reused: "r" if SSL/TLS session was $tls_session_reused: "r" if SSL/TLS session was
reused. Otherwise, "." reused. Otherwise, "."
.IP \(bu 2 .IP \(bu 2
$tls_sni: SNI server name for SSL/TLS connection.
.IP \(bu 2
$backend_host: backend host used to fulfill the $backend_host: backend host used to fulfill the
request. "\-" if backend host is not available. request. "\-" if backend host is not available.
.IP \(bu 2 .IP \(bu 2

32
doc/nghttpx.1.rst
View File

@ -57,14 +57,16 @@ Connections
which only lacks trailing '*/*' (e.g., path "*/foo/*" which only lacks trailing '*/*' (e.g., path "*/foo/*"
matches request path "*/foo*"). If it does not end with matches request path "*/foo*"). If it does not end with
"*/*", it performs exact match against the request path. "*/*", it performs exact match against the request path.
If host is given, it performs exact match against the If host is given, it performs a match against the
request host. If host alone is given, "*/*" is appended request host. For a request received on the frontend
to it, so that it matches all request paths under the lister with "sni-fwd" parameter enabled, SNI host is
host (e.g., specifying "nghttp2.org" equals to used instead of a request host. If host alone is given,
"nghttp2.org/"). CONNECT method is treated specially. "*/*" is appended to it, so that it matches all request
It does not have path, and we don't allow empty path. paths under the host (e.g., specifying "nghttp2.org"
To workaround this, we assume that CONNECT method has equals to "nghttp2.org/"). CONNECT method is treated
"*/*" as path. specially. It does not have path, and we don't allow
empty path. To workaround this, we assume that CONNECT
method has "*/*" as path.
Patterns with host take precedence over patterns with Patterns with host take precedence over patterns with
just path. Then, longer patterns take precedence over just path. Then, longer patterns take precedence over
@ -205,6 +207,11 @@ Connections
Optionally, TLS can be disabled by specifying "no-tls" Optionally, TLS can be disabled by specifying "no-tls"
parameter. TLS is enabled by default. parameter. TLS is enabled by default.
If "sni-fwd" parameter is used, when performing a match
to select a backend server, SNI host name received from
the client is used instead of the request host. See
:option:`--backend` option about the pattern match.
To make this frontend as API endpoint, specify "api" To make this frontend as API endpoint, specify "api"
parameter. This is disabled by default. It is parameter. This is disabled by default. It is
important to limit the access to the API frontend. important to limit the access to the API frontend.
@ -1039,11 +1046,12 @@ Logging
* $alpn: ALPN identifier of the protocol which generates * $alpn: ALPN identifier of the protocol which generates
the response. For HTTP/1, ALPN is always http/1.1, the response. For HTTP/1, ALPN is always http/1.1,
regardless of minor version. regardless of minor version.
* $ssl_cipher: cipher used for SSL/TLS connection. * $tls_cipher: cipher used for SSL/TLS connection.
* $ssl_protocol: protocol for SSL/TLS connection. * $tls_protocol: protocol for SSL/TLS connection.
* $ssl_session_id: session ID for SSL/TLS connection. * $tls_session_id: session ID for SSL/TLS connection.
* $ssl_session_reused: "r" if SSL/TLS session was * $tls_session_reused: "r" if SSL/TLS session was
reused. Otherwise, "." reused. Otherwise, "."
* $tls_sni: SNI server name for SSL/TLS connection.
* $backend_host: backend host used to fulfill the * $backend_host: backend host used to fulfill the
request. "-" if backend host is not available. request. "-" if backend host is not available.
* $backend_port: backend port used to fulfill the * $backend_port: backend port used to fulfill the