2015-01-09 16:37:42 +01:00
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
.
|
2015-01-11 11:03:45 +01:00
|
|
|
.TH "H2LOAD" "1" "January 11, 2015" "0.7.1" "nghttp2"
|
2014-05-09 17:34:56 +02:00
|
|
|
.SH NAME
|
|
|
|
h2load \- HTTP/2 benchmarking tool
|
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-05-09 17:34:56 +02:00
|
|
|
.SH SYNOPSIS
|
2015-01-09 16:37:42 +01:00
|
|
|
.sp
|
|
|
|
\fBh2load\fP [OPTIONS]... [URI]...
|
2014-05-09 17:34:56 +02:00
|
|
|
.SH DESCRIPTION
|
2015-01-09 16:37:42 +01:00
|
|
|
.sp
|
2014-05-09 17:34:56 +02:00
|
|
|
benchmarking tool for HTTP/2 and SPDY server
|
2015-01-09 16:37:42 +01:00
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B <URI>
|
2014-05-09 17:34:56 +02:00
|
|
|
Specify URI to access. Multiple URIs can be
|
|
|
|
specified. URIs are used in this order for each
|
|
|
|
client. All URIs are used, then first URI is
|
|
|
|
used and then 2nd URI, and so on. The scheme,
|
|
|
|
host and port in the subsequent URIs, if present,
|
|
|
|
are ignored. Those in the first URI are used
|
|
|
|
solely.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.SH OPTIONS:
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-n, \-\-requests=<N>
|
|
|
|
Number of requests.
|
|
|
|
.sp
|
|
|
|
Default: \fB1\fP
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-c, \-\-clients=<N>
|
|
|
|
Number of concurrent clients.
|
|
|
|
.sp
|
|
|
|
Default: \fB1\fP
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-t, \-\-threads=<N>
|
|
|
|
Number of native threads.
|
|
|
|
.sp
|
|
|
|
Default: \fB1\fP
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-i, \-\-input\-file=<FILE>
|
2014-10-27 16:35:44 +01:00
|
|
|
Path of a file with multiple URIs are seperated
|
|
|
|
by EOLs. This option will disable URIs getting
|
2015-01-09 16:37:42 +01:00
|
|
|
from command\-line. If \(aq\-\(aq is given as <FILE>,
|
2014-10-27 16:35:44 +01:00
|
|
|
URIs will be read from stdin. URIs are used in
|
|
|
|
this order for each client. All URIs are used,
|
|
|
|
then first URI is used and then 2nd URI, and so
|
|
|
|
on. The scheme, host and port in the subsequent
|
|
|
|
URIs, if present, are ignored. Those in the
|
|
|
|
first URI are used solely.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-10-27 16:35:44 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-m, \-\-max\-concurrent\-streams=(auto|<N>)
|
2014-05-09 17:34:56 +02:00
|
|
|
Max concurrent streams to issue per session. If
|
|
|
|
"auto" is given, the number of given URIs is
|
2015-01-09 16:37:42 +01:00
|
|
|
used.
|
|
|
|
.sp
|
|
|
|
Default: \fBauto\fP
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-w, \-\-window\-bits=<N>
|
2014-05-09 17:34:56 +02:00
|
|
|
Sets the stream level initial window size to
|
|
|
|
(2**<N>)\-1. For SPDY, 2**<N> is used instead.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-W, \-\-connection\-window\-bits=<N>
|
2014-05-09 17:34:56 +02:00
|
|
|
Sets the connection level initial window size to
|
|
|
|
(2**<N>)\-1. For SPDY, if <N> is strictly less
|
|
|
|
than 16, this option is ignored. Otherwise
|
|
|
|
2**<N> is used for SPDY.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-H, \-\-header=<HEADER>
|
2014-10-27 16:35:44 +01:00
|
|
|
Add/Override a header to the requests.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-10-27 16:35:44 +01:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-p, \-\-no\-tls\-proto=<PROTOID>
|
2014-05-09 17:34:56 +02:00
|
|
|
Specify ALPN identifier of the protocol to be
|
|
|
|
used when accessing http URI without SSL/TLS.
|
|
|
|
Available protocols: spdy/2, spdy/3, spdy/3.1 and
|
2014-08-16 15:54:15 +02:00
|
|
|
h2c\-14
|
2015-01-09 16:37:42 +01:00
|
|
|
.sp
|
|
|
|
Default: \fBh2c\-14\fP
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-v, \-\-verbose
|
2014-05-09 17:34:56 +02:00
|
|
|
Output debug information.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-\-version
|
2014-05-09 17:34:56 +02:00
|
|
|
Display version information and exit.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2014-05-09 17:34:56 +02:00
|
|
|
.TP
|
2015-01-09 16:37:42 +01:00
|
|
|
.B \-h, \-\-help
|
2014-05-09 17:34:56 +02:00
|
|
|
Display this help and exit.
|
2015-01-09 16:37:42 +01:00
|
|
|
.UNINDENT
|
|
|
|
.SH SEE ALSO
|
|
|
|
.sp
|
|
|
|
\fInghttp(1)\fP, \fInghttpd(1)\fP, \fInghttpx(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.
|
|
|
|
.
|