← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/apache2/jaunty-proposed

« back to all changes in this revision

Viewing changes to docs/manual/programs/ab.html.en

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2008-12-15 00:06:50 UTC
  • mfrom: (14.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20081215000650-5ovq2vvvrtmn5r1l
Tags: 2.2.11-1ubuntu1
* Merge from debian unstable, remaining changes:
  - debian/{control, rules}: enable PIE hardening.
  - debian/{control, rules, apache2.2-common.ufw.profile}: add ufw profiles.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manual/programs/ab.html.en
19
19
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.2</a> &gt; <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>ab - Apache HTTP server benchmarking tool</h1>
20
20
<div class="toplang">
21
21
<p><span>Available Languages: </span><a href="../en/programs/ab.html" title="English">&nbsp;en&nbsp;</a> |
22
 
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 
22
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 
23
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
23
24
</div>
24
25
 
25
26
    <p><code>ab</code> is a tool for benchmarking your Apache Hypertext
37
38
<h2><a name="synopsis" id="synopsis">Synopsis</a></h2>
38
39
    <p><code><strong>ab</strong>
39
40
    [ -<strong>A</strong> <var>auth-username</var>:<var>password</var> ]
 
41
    [ -<strong>b</strong> <var>windowsize</var> ]
40
42
    [ -<strong>c</strong> <var>concurrency</var> ]
41
43
    [ -<strong>C</strong> <var>cookie-name</var>=<var>value</var> ]
42
44
    [ -<strong>d</strong> ]
43
45
    [ -<strong>e</strong> <var>csv-file</var> ]
 
46
    [ -<strong>f</strong> <var>protocol</var> ]
44
47
    [ -<strong>g</strong> <var>gnuplot-file</var> ]
45
48
    [ -<strong>h</strong> ]
46
49
    [ -<strong>H</strong> <var>custom-header</var> ]
50
53
    [ -<strong>p</strong> <var>POST-file</var> ]
51
54
    [ -<strong>P</strong> <var>proxy-auth-username</var>:<var>password</var> ]
52
55
    [ -<strong>q</strong> ]
 
56
    [ -<strong>r</strong> ]
53
57
    [ -<strong>s</strong> ]
54
58
    [ -<strong>S</strong> ]
55
59
    [ -<strong>t</strong> <var>timelimit</var> ]
61
65
    [ -<strong>X</strong> <var>proxy</var>[:<var>port</var>] ]
62
66
    [ -<strong>y</strong> <var>&lt;tr&gt;-attributes</var> ]
63
67
    [ -<strong>z</strong> <var>&lt;td&gt;-attributes</var> ]
64
 
    [http://]<var>hostname</var>[:<var>port</var>]/<var>path</var></code></p>
 
68
    [ -<strong>Z</strong> <var>ciphersuite</var> ]
 
69
    [http[s]://]<var>hostname</var>[:<var>port</var>]/<var>path</var></code></p>
65
70
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
66
71
<div class="section">
67
72
<h2><a name="options" id="options">Options</a></h2>
72
77
    base64 encoded. The string is sent regardless of whether the server needs
73
78
    it (<em>i.e.</em>, has sent an 401  authentication needed).</dd>
74
79
 
 
80
    <dt><code>-b <var>windowsize</var></code></dt>
 
81
    <dd>Size of TCP send/receive buffer, in bytes.</dd>
 
82
 
75
83
    <dt><code>-c <var>concurrency</var></code></dt>
76
84
    <dd>Number of multiple requests to perform at a time. Default is one
77
85
    request at a time.</dd>
91
99
    that percentage of the requests. This is usually more useful than the
92
100
    'gnuplot' file; as the results are already 'binned'.</dd>
93
101
 
 
102
    <dt><code>-f <var>protocol</var></code></dt>
 
103
    <dd>Specify SSL/TLS protocol (SSL2, SSL3, TLS1, or ALL).</dd>
 
104
 
94
105
    <dt><code>-g <var>gnuplot-file</var></code></dt>
95
106
    <dd>Write all measured values out as a 'gnuplot' or TSV (Tab separate
96
107
    values) file. This file can easily be imported into packages like Gnuplot,
118
129
    non-representative benchmarking results.</dd>
119
130
 
120
131
    <dt><code>-p <var>POST-file</var></code></dt>
121
 
    <dd>File containing data to POST.</dd>
 
132
    <dd>File containing data to POST.  Remember to also set <code>-T</code>.</dd>
122
133
 
123
134
    <dt><code>-P <var>proxy-auth-username</var>:<var>password</var></code></dt>
124
135
    <dd>Supply BASIC Authentication credentials to a proxy en-route. The
125
 
    username and password are separated by a single <code>:</code> and sent on 
 
136
    username and password are separated by a single <code>:</code> and sent on
126
137
    the  wire base64 encoded. The string is sent regardless of whether the
127
138
    proxy needs it (<em>i.e.</em>, has  sent an 407 proxy authentication
128
139
    needed).</dd>
129
140
 
130
141
    <dt><code>-q</code></dt>
131
142
    <dd>When processing more than 150 requests, <code>ab</code> outputs a
132
 
    progress count on <code>stderr</code> every 10% or 100 requests or so. The 
 
143
    progress count on <code>stderr</code> every 10% or 100 requests or so. The
133
144
    <code>-q</code> flag will suppress these messages.</dd>
134
145
 
135
 
    <dt><code>-s</code></dt>
 
146
    <dt><code>-r</code></dt>
 
147
    <dd>Don't exit on socket receive errors.</dd>
 
148
 
 
149
   <dt><code>-s</code></dt>
136
150
    <dd>When compiled in (<code>ab -h</code> will show you) use the SSL
137
151
    protected <code>https</code> rather than the <code>http</code> protocol.
138
152
    This feature is experimental and <em>very</em> rudimentary. You probably
141
155
    <dt><code>-S</code></dt>
142
156
    <dd>Do not display the median and standard deviation values, nor display
143
157
    the warning/error messages when the average and median are more than
144
 
    one or two times the standard deviation apart. And default to the 
 
158
    one or two times the standard deviation apart. And default to the
145
159
    min/avg/max values. (legacy support).</dd>
146
160
 
147
161
    <dt><code>-t <var>timelimit</var></code></dt>
150
164
    fixed total amount of time. Per default there is no timelimit.</dd>
151
165
 
152
166
    <dt><code>-T <var>content-type</var></code></dt>
153
 
    <dd>Content-type header to use for POST data.</dd>
 
167
    <dd>Content-type header to use for POST data, eg.
 
168
    <code>application/x-www-form-urlencoded</code>.
 
169
    Default: <code>text/plain</code>.</dd>
154
170
 
155
171
    <dt><code>-v <var>verbosity</var></code></dt>
156
172
    <dd>Set verbosity level - <code>4</code> and above prints information on
176
192
 
177
193
    <dt><code>-z <var>&lt;td&gt;-attributes</var></code></dt>
178
194
    <dd>String to use as attributes for <code>&lt;td&gt;</code>.</dd>
 
195
 
 
196
    <dt><code>-Z <var>ciphersuite</var></code></dt>
 
197
    <dd>Specify SSL/TLS cipher suite (See openssl ciphers).</dd>
179
198
    </dl>
180
199
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
181
200
<div class="section">
191
210
</div></div>
192
211
<div class="bottomlang">
193
212
<p><span>Available Languages: </span><a href="../en/programs/ab.html" title="English">&nbsp;en&nbsp;</a> |
194
 
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 
213
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 
214
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
195
215
</div><div id="footer">
196
216
<p class="apache">Copyright 2008 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
197
217
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>