2015-01-09 16:37:42 +01:00
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
.
|
2015-01-11 11:03:45 +01:00
|
|
|
.TH "NGHTTP" "1" "January 11, 2015" "0.7.1" "nghttp2"
|
2014-02-15 08:46:11 +01:00
|
|
|
.SH NAME
|
2014-05-16 16:54:09 +02:00
|
|
|
nghttp \- HTTP/2 experimental client
|
2015-01-09 16:37:42 +01:00
|
|
|
.
|
|
|
|
.nr rst2man-indent-level 0
|
|
|
|
.
|
|
|
|
.de1 rstReportMargin
|
|
|
|
\\$1 \\n[an-margin]
|
|
|
|
level \\n[rst2man-indent-level]
|
|
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
-
|
|
|
|
\\n[rst2man-indent0]
|
|
|
|
\\n[rst2man-indent1]
|
|
|
|
\\n[rst2man-indent2]
|
|
|
|
..
|
|
|
|
.de1 INDENT
|
|
|
|
.\" .rstReportMargin pre:
|
|
|
|
. RS \\$1
|
|
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
|
|
. nr rst2man-indent-level +1
|
|
|
|
.\" .rstReportMargin post:
|
|
|
|
..
|
|
|
|
.de UNINDENT
|
|
|
|
. RE
|
|
|
|
.\" indent \\n[an-margin]
|
|
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
.nr rst2man-indent-level -1
|
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
|
..
|
2014-02-15 08:46:11 +01:00
|
|
|
.SH SYNOPSIS
|
2015-01-09 16:37:42 +01:00
|
|
|
.sp
|
|
|
|
\fBnghttp\fP [OPTIONS]... <URI>...
|
2014-02-15 08:46:11 +01:00
|
|
|
.SH DESCRIPTION
|
2015-01-09 16:37:42 +01:00
|
|
|
.sp
|
2014-05-16 16:54:09 +02:00
|
|
|
HTTP/2 experimental client
|
2015-01-09 16:37:42 +01:00
|
|
|
.INDENT 0.0
|
2014-05-16 16:54:09 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B <URI>
|
2014-05-16 16:54:09 +02:00
|
|
|
Specify URI to access.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.SH OPTIONS:
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-v, \-\-verbose
|
2014-05-16 16:54:09 +02:00
|
|
|
Print debug information such as reception and
|
2014-11-08 14:55:24 +01:00
|
|
|
transmission of frames and name/value pairs.
|
|
|
|
Specifying this option multiple times increases
|
|
|
|
verbosity.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-n, \-\-null\-out
|
2014-02-15 08:46:11 +01:00
|
|
|
Discard downloaded data.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-O, \-\-remote\-name
|
2014-05-16 16:54:09 +02:00
|
|
|
Save download data in the current directory. The
|
|
|
|
filename is dereived from URI. If URI ends with
|
2015-01-09 16:37:42 +01:00
|
|
|
\(aq\fI/\fP\(aq, \(aqindex.html\(aq is used as a filename. Not
|
2014-05-16 16:54:09 +02:00
|
|
|
implemented yet.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-t, \-\-timeout=<N>
|
2014-02-15 08:46:11 +01:00
|
|
|
Timeout each request after <N> seconds.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-w, \-\-window\-bits=<N>
|
2014-05-16 16:54:09 +02:00
|
|
|
Sets the stream level initial window size to
|
|
|
|
2**<N>\-1.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-W, \-\-connection\-window\-bits=<N>
|
2014-05-16 16:54:09 +02:00
|
|
|
Sets the connection level initial window size to
|
|
|
|
2**<N>\-1.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-a, \-\-get\-assets
|
2014-05-16 16:54:09 +02:00
|
|
|
Download assets such as stylesheets, images and
|
|
|
|
script files linked from the downloaded resource.
|
|
|
|
Only links whose origins are the same with the
|
2014-10-27 16:35:44 +01:00
|
|
|
linking resource will be downloaded. nghttp
|
|
|
|
prioritizes resources using HTTP/2 dependency
|
|
|
|
based priority. The priority order, from highest
|
|
|
|
to lowest, is html itself, css, javascript and
|
|
|
|
images.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-s, \-\-stat
|
2014-02-15 08:46:11 +01:00
|
|
|
Print statistics.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-H, \-\-header=<HEADER>
|
2014-10-27 16:35:44 +01:00
|
|
|
Add a header to the requests. Example:
|
2015-01-09 16:37:42 +01:00
|
|
|
\fI\%\-H\fP\(aq:method: PUT\(aq
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-cert=<CERT>
|
2014-05-16 16:54:09 +02:00
|
|
|
Use the specified client certificate file. The
|
|
|
|
file must be in PEM format.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-key=<KEY>
|
2014-05-16 16:54:09 +02:00
|
|
|
Use the client private key file. The file must
|
|
|
|
be in PEM format.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-d, \-\-data=<FILE>
|
|
|
|
Post FILE to server. If \(aq\-\(aq is given, data will
|
2014-05-16 16:54:09 +02:00
|
|
|
be read from stdin.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-m, \-\-multiply=<N>
|
|
|
|
Request each URI <N> times. By default, same URI
|
2014-05-16 16:54:09 +02:00
|
|
|
is not requested twice. This option disables it
|
|
|
|
too.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-u, \-\-upgrade
|
2014-05-16 16:54:09 +02:00
|
|
|
Perform HTTP Upgrade for HTTP/2. This option is
|
|
|
|
ignored if the request URI has https scheme. If
|
2015-01-09 16:37:42 +01:00
|
|
|
\fI\-d\fP is used, the HTTP upgrade request is performed
|
2014-05-16 16:54:09 +02:00
|
|
|
with OPTIONS method.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-p, \-\-weight=<WEIGHT>
|
2014-05-16 16:54:09 +02:00
|
|
|
Sets priority group weight. The valid value
|
|
|
|
range is [1, 256], inclusive.
|
2015-01-09 16:37:42 +01:00
|
|
|
.sp
|
|
|
|
Default: \fB16\fP
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-M, \-\-peer\-max\-concurrent\-streams=<N>
|
2014-05-16 16:54:09 +02:00
|
|
|
Use <N> as SETTINGS_MAX_CONCURRENT_STREAMS value
|
|
|
|
of remote endpoint as if it is received in
|
|
|
|
SETTINGS frame. The default is large enough as
|
|
|
|
it is seen as unlimited.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-c, \-\-header\-table\-size=<N>
|
2014-02-15 08:46:11 +01:00
|
|
|
Specify decoder header table size.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-02-15 08:46:11 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-b, \-\-padding=<N>
|
2014-05-16 16:54:09 +02:00
|
|
|
Add at most <N> bytes to a frame payload as
|
|
|
|
padding. Specify 0 to disable padding.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-16 16:54:09 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-r, \-\-har=<FILE>
|
2014-11-24 07:27:41 +01:00
|
|
|
Output HTTP transactions <FILE> in HAR format.
|
2015-01-09 16:37:42 +01:00
|
|
|
If \(aq\-\(aq is given, data is written to stdout.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-11-24 07:27:41 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-color
|
2014-02-15 08:46:11 +01:00
|
|
|
Force colored log output.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-16 16:54:09 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-continuation
|
2014-05-16 16:54:09 +02:00
|
|
|
Send large header to test CONTINUATION.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-16 16:54:09 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-no\-content\-length
|
|
|
|
Don\(aqt send content\-length header field.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-07-08 17:38:43 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-no\-dep
|
|
|
|
Don\(aqt send dependency based priority hint to
|
2014-11-24 07:27:41 +01:00
|
|
|
server.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-11-24 07:27:41 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-dep\-idle
|
2015-01-06 17:40:55 +01:00
|
|
|
Use idle streams as anchor nodes to express
|
|
|
|
priority.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2015-01-06 17:40:55 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-version
|
2014-05-16 16:54:09 +02:00
|
|
|
Display version information and exit.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-16 16:54:09 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-h, \-\-help
|
2014-05-16 16:54:09 +02:00
|
|
|
Display this help and exit.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.SH SEE ALSO
|
|
|
|
.sp
|
|
|
|
\fInghttpd(1)\fP, \fInghttpx(1)\fP, \fIh2load(1)\fP
|
|
|
|
.SH AUTHOR
|
|
|
|
Tatsuhiro Tsujikawa
|
|
|
|
.SH COPYRIGHT
|
2015-01-10 09:12:24 +01:00
|
|
|
2012, 2015, Tatsuhiro Tsujikawa
|
2015-01-09 16:37:42 +01:00
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
.
|