nghttp2/doc/nghttp.1

218 lines
4.6 KiB
Groff
Raw Normal View History

.\" Man page generated from reStructuredText.
.
.TH "NGHTTP" "1" "January 10, 2015" "0.7.1-DEV" "nghttp2"
.SH NAME
2014-05-16 16:54:09 +02:00
nghttp \- HTTP/2 experimental client
.
.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
..
.SH SYNOPSIS
.sp
\fBnghttp\fP [OPTIONS]... <URI>...
.SH DESCRIPTION
.sp
2014-05-16 16:54:09 +02:00
HTTP/2 experimental client
.INDENT 0.0
2014-05-16 16:54:09 +02:00
.TP
.B <URI>
2014-05-16 16:54:09 +02:00
Specify URI to access.
.UNINDENT
.SH OPTIONS:
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
.TP
.B \-n, \-\-null\-out
Discard downloaded data.
.UNINDENT
.INDENT 0.0
.TP
.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
\(aq\fI/\fP\(aq, \(aqindex.html\(aq is used as a filename. Not
2014-05-16 16:54:09 +02:00
implemented yet.
.UNINDENT
.INDENT 0.0
.TP
.B \-t, \-\-timeout=<N>
Timeout each request after <N> seconds.
.UNINDENT
.INDENT 0.0
.TP
.B \-w, \-\-window\-bits=<N>
2014-05-16 16:54:09 +02:00
Sets the stream level initial window size to
2**<N>\-1.
.UNINDENT
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-stat
Print statistics.
.UNINDENT
.INDENT 0.0
.TP
.B \-H, \-\-header=<HEADER>
2014-10-27 16:35:44 +01:00
Add a header to the requests. Example:
\fI\%\-H\fP\(aq:method: PUT\(aq
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cert=<CERT>
2014-05-16 16:54:09 +02:00
Use the specified client certificate file. The
file must be in PEM format.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-key=<KEY>
2014-05-16 16:54:09 +02:00
Use the client private key file. The file must
be in PEM format.
.UNINDENT
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
.TP
.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
\fI\-d\fP is used, the HTTP upgrade request is performed
2014-05-16 16:54:09 +02:00
with OPTIONS method.
.UNINDENT
.INDENT 0.0
.TP
.B \-p, \-\-weight=<WEIGHT>
2014-05-16 16:54:09 +02:00
Sets priority group weight. The valid value
range is [1, 256], inclusive.
.sp
Default: \fB16\fP
.UNINDENT
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-header\-table\-size=<N>
Specify decoder header table size.
.UNINDENT
.INDENT 0.0
.TP
.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.
.UNINDENT
.INDENT 0.0
2014-05-16 16:54:09 +02:00
.TP
.B \-r, \-\-har=<FILE>
2014-11-24 07:27:41 +01:00
Output HTTP transactions <FILE> in HAR format.
If \(aq\-\(aq is given, data is written to stdout.
.UNINDENT
.INDENT 0.0
2014-11-24 07:27:41 +01:00
.TP
.B \-\-color
Force colored log output.
.UNINDENT
.INDENT 0.0
2014-05-16 16:54:09 +02:00
.TP
.B \-\-continuation
2014-05-16 16:54:09 +02:00
Send large header to test CONTINUATION.
.UNINDENT
.INDENT 0.0
2014-05-16 16:54:09 +02:00
.TP
.B \-\-no\-content\-length
Don\(aqt send content\-length header field.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-dep
Don\(aqt send dependency based priority hint to
2014-11-24 07:27:41 +01:00
server.
.UNINDENT
.INDENT 0.0
2014-11-24 07:27:41 +01:00
.TP
.B \-\-dep\-idle
2015-01-06 17:40:55 +01:00
Use idle streams as anchor nodes to express
priority.
.UNINDENT
.INDENT 0.0
2015-01-06 17:40:55 +01:00
.TP
.B \-\-version
2014-05-16 16:54:09 +02:00
Display version information and exit.
.UNINDENT
.INDENT 0.0
2014-05-16 16:54:09 +02:00
.TP
.B \-h, \-\-help
2014-05-16 16:54:09 +02:00
Display this help and exit.
.UNINDENT
.SH SEE ALSO
.sp
\fInghttpd(1)\fP, \fInghttpx(1)\fP, \fIh2load(1)\fP
.SH AUTHOR
Tatsuhiro Tsujikawa
.SH COPYRIGHT
2012, 2014, Tatsuhiro Tsujikawa
.\" Generated by docutils manpage writer.
.