summaryrefslogtreecommitdiff
path: root/docs/manual/programs/ab.html.en
diff options
context:
space:
mode:
Diffstat (limited to 'docs/manual/programs/ab.html.en')
-rw-r--r--docs/manual/programs/ab.html.en87
1 files changed, 87 insertions, 0 deletions
diff --git a/docs/manual/programs/ab.html.en b/docs/manual/programs/ab.html.en
index 2231b98c..1420a554 100644
--- a/docs/manual/programs/ab.html.en
+++ b/docs/manual/programs/ab.html.en
@@ -31,6 +31,7 @@
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#output">Output</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bugs</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -206,6 +207,92 @@
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
+<h2><a name="output" id="output">Output</a></h2>
+ <p>The following list describes the values returned by <code>ab</code>:
+ </p>
+
+ <dl>
+ <dt>Server Software</dt>
+ <dd>The value, if any, returned in the <var>server</var> HTTP header
+ of the first successful response. This includes all characters in the
+ header from beginning to the point a character with decimal value of 32
+ (most notably: a space or CR/LF) is detected.</dd>
+
+ <dt>Server Hostname</dt>
+ <dd>The DNS or IP address given on the command line</dd>
+
+ <dt>Server Port</dt>
+ <dd>The port to which ab is connecting. If no port is given on the
+ command line, this will default to 80 for http and 443 for
+ https.</dd>
+
+ <dt>SSL/TLS Protocol</dt>
+ <dd>The protocol parameters negotiated between the client and server.
+ This will only be printed if SSL is used.</dd>
+
+ <dt>Document Path</dt>
+ <dd>The request URI parsed from the command line string.</dd>
+
+ <dt>Document Length</dt>
+ <dd>This is size in bytes of the first succesfully returning document.
+ If the document length changes during testing, the response is
+ considered an error.</dd>
+
+ <dt>Concurrency Level</dt>
+ <dd>The number of concurrent clients used during the test</dd>
+
+ <dt>Time taken for tests</dt>
+ <dd>This is the time taken from the moment the first socket connection
+ is created to the moment the last response is recieved</dd>
+
+ <dt>Complete requests</dt>
+ <dd>The number of successful responses recieved</dd>
+
+ <dt>Failed requests</dt>
+ <dd>The number of requests that were considered a failure. If the
+ number is greater than zero, another line will be printed showing the
+ number of requests that failed due to connecting, reading, incorrect
+ content length, or exceptions.</dd>
+
+ <dt>Write errors</dt>
+ <dd>The number of errors that failed during write (broken pipe).</dd>
+
+ <dt>Non-2xx responses</dt>
+ <dd>The number of responses that were not in the 200 series of response
+ codes. If all responses were 200, this field is not printed.</dd>
+
+ <dt>Keep-Alive requests</dt>
+ <dd>The number of connections that resulted in Keep-Alive requests</dd>
+
+ <dt>Total body sent</dt>
+ <dd>If configured to send data as part of the test, this is the total
+ number of bytes sent during the tests. This field is omitted if the test
+ did not include a body to send.</dd>
+
+ <dt>Total transferred</dt>
+ <dd>The total number of bytes received from the server. This number
+ is essentially the number of bytes sent over the wire.</dd>
+
+ <dt>HTML transferred</dt>
+ <dd>The total number of document bytes received from the server. This
+ number excludes bytes received in HTTP headers</dd>
+
+ <dt>Requests per second</dt>
+ <dd>This is the number of requests per second. This value is the result
+ of dividing the number of requests by the total time taken</dd>
+
+ <dt>Time per request</dt>
+ <dd>The average time spent per request. The first value is calculated
+ with the formula <code>concurrency * timetaken * 1000 / done</code>
+ while the second value is calculated with the formula
+ <code>timetaken * 1000 / done</code></dd>
+
+ <dt>Transfer rate</dt>
+ <dd>The rate of transfer as calculated by the formula
+ <code>totalread / 1024 / timetaken</code></dd>
+ </dl>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
<h2><a name="bugs" id="bugs">Bugs</a></h2>
<p>There are various statically declared buffers of fixed length. Combined
with the lazy parsing of the command line arguments, the response headers