diff options
Diffstat (limited to 'APACHE_1_3_42/htdocs/manual/programs/ab.html')
| -rw-r--r-- | APACHE_1_3_42/htdocs/manual/programs/ab.html | 153 |
1 files changed, 153 insertions, 0 deletions
diff --git a/APACHE_1_3_42/htdocs/manual/programs/ab.html b/APACHE_1_3_42/htdocs/manual/programs/ab.html new file mode 100644 index 0000000000..652fff0389 --- /dev/null +++ b/APACHE_1_3_42/htdocs/manual/programs/ab.html @@ -0,0 +1,153 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta name="generator" content="HTML Tidy, see www.w3.org" /> + + <title>Manual Page: ab - Apache HTTP Server</title> + </head> + <!-- Background white, links blue (unvisited), navy (visited), red (active) --> + + <body bgcolor="#ffffff" text="#000000" link="#0000ff" + vlink="#000080" alink="#ff0000"> + <!--#include virtual="header.html" --> + + <h1 align="center">Manual Page: ab</h1> + <!-- This document was autogenerated from the man page --> +<pre> +<strong>NAME</strong> + ab - Apache HTTP server benchmarking tool + +<strong>SYNOPSIS</strong> + <strong>ab</strong> [ -<strong>k</strong> ] [ -<strong>i</strong> ] [ -<strong>n</strong> <em>requests</em> ] [ -<strong>t</strong> <em>timelimit</em> ] [ -<strong>c</strong> <em>con-</em> + <em>currency</em> ] [ -<strong>p</strong> <em>POST file</em> ] [ -<strong>A</strong> <em>Authenticate</em> + <em>username</em>:<em>password </em> ] [ -<strong>P </strong> <em>Proxy Authenticate</em> + <em>username</em>:<em>password</em> ] [ -<strong>H</strong> <em>Custom header</em> ] [ -<strong>C</strong> <em>Cookie</em> + <em>name</em>=<em>value</em> ] [ -<strong>T</strong> <em>content</em>-<em>type</em> ] [ -<strong>v</strong> <em>verbosity</em> ] [ -<strong>w</strong> + <em>output HTML</em> ] [ -<strong>x</strong> <<em>table</em>> <em>attributes</em> ] [ -<strong>X</strong> <em>proxy[:port]</em> ] + [ -<strong>y</strong> <<em>tr</em>> <em>attributes </em> ] [ -<strong>z</strong> <<em>td</em>> <em>attributes </em> ] + [<em>http</em>://]<em>hostname</em>[:<em>port</em>]/<em>path</em> + + <strong>ab</strong> [ -<strong>V</strong> ] [ -<strong>h</strong> ] + +<strong>DESCRIPTION</strong> + <strong>ab</strong> is a tool for benchmarking the performance of your Apache + HyperText Transfer Protocol (HTTP) server. It does this by + giving you an indication of how many requests per second + your Apache installation can serve. + +<strong>OPTIONS</strong> + -<strong>k </strong> Enable the HTTP KeepAlive feature; that is, per- + form multiple requests within one HTTP session. + Default is no KeepAlive. + + -<strong>i </strong> Use an HTTP 'HEAD' instead of the GET method. + Cannot be mixed with POST. + + -<strong>n</strong> <em>requests</em> The number of requests to perform for the bench- + marking session. The default is to perform just + one single request, which will not give + representative benchmarking results. + + -<strong>t</strong> <em>timelimit</em> + The number of seconds to spend benchmarking. + Using this option automatically set the number + of requests for the benchmarking session to + 50000. Use this to benchmark the server for a + fixed period of time. By default, there is no + timelimit. + + -<strong>c</strong> <em>concurrency</em> + The number of simultaneous requests to perform. + The default is to perform one HTTP request at a + time, that is, no concurrency. + + -<strong>p</strong> <em>POST file</em> + A file containing data that the program will + send to the Apache server in any HTTP POST + requests. The contents of the file should look + like <code>name=value&something=other</code>, with special + characters URL encoded. + + -<strong>A</strong> <em>Authorization username</em>:<em>password</em> + Supply Basic Authentication credentials to the + server. The username and password are separated + by a single ':', and sent as uuencoded data. + The string is sent regardless of whether the + server needs it; that is, has sent a 401 Authen- + tication needed. + + -<strong>P</strong> <em>Proxy</em>-<em>Authorization username</em>:<em>password</em> + Supply Basic Authentication credentials to a + proxy en-route. The username and password are + separated by a single ':', and sent as uuencoded + data. The string is sent regardless of whether + the proxy needs it; that is, has sent a 407 + Proxy authentication needed. + + -<strong>C</strong> <em>Cookie name</em>=<em>value</em> + Add a 'Cookie:' line to the request. The argu- + ment is typically a 'name=value' pair. This + option may be repeated. + + -<strong>H</strong> <em>Header string</em> + Append extra headers to the request. The argu- + ment is typically in the form of a valid header + line, usually a colon separated field value + pair, for example, 'Accept-Encoding: + zip/zop;8bit'. + + -<strong>T</strong> <em>content</em>-<em>type</em> + The content-type header to use for POST data. + + -<strong>v </strong> Sets the verbosity level. Level 4 and above + prints information on headers, level 3 and above + prints response codes (for example, 404, 200), + and level 2 and above prints warnings and infor- + mational messages. + + -<strong>w </strong> Print out results in HTML tables. The default + table is two columns wide, with a white back- + ground. + + -<strong>x</strong> <em>attributes</em> + The string to use as attributes for <table>. + Attributes are inserted <table <strong>here</strong> > + + -<strong>X</strong> <em>proxy:port</em> + Use the specified proxy server, running on the + specified port. + + -<strong>y</strong> <em>attributes</em> + The string to use as attributes for <tr>. + + -<strong>z</strong> <em>attributes</em> + The string to use as attributes for <td>. + + -<strong>V </strong> Display the version number and exit. + + -<strong>h </strong> Display usage information. + +<strong>BUGS</strong> + There are various statically declared buffers of fixed + length. Combined with inefficient parsing of the command + line arguments, the response headers from the server, and + other external inputs, these buffers might overflow. + + <strong>Ab</strong> does not implement HTTP/1.x fully; instead, it only + accepts some 'expected' forms of responses. + + The rather heavy use of <strong>strstr(3)</strong> by the program may skew + performance results, since it uses significant CPU + resources. Make sure that performance limits are not hit by + <strong>ab</strong> before your server's limit is reached. + +<strong>SEE ALSO</strong> + <strong>httpd(8)</strong> + +</pre> + <!--#include virtual="footer.html" --> + </body> +</html> + |