diff options
Diffstat (limited to 'usr.sbin/httpd/htdocs/manual/programs/ab.html')
| -rw-r--r-- | usr.sbin/httpd/htdocs/manual/programs/ab.html | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/usr.sbin/httpd/htdocs/manual/programs/ab.html b/usr.sbin/httpd/htdocs/manual/programs/ab.html new file mode 100644 index 00000000000..4df2cbfd638 --- /dev/null +++ b/usr.sbin/httpd/htdocs/manual/programs/ab.html @@ -0,0 +1,164 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<html> +<head> + <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" + > + <DIV ALIGN="CENTER"> + <IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]"> + <H3> + Apache HTTP Server Version 1.3 + </H3> +</DIV> + + + + <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>y </strong><<em>tr</em>> <em>attri-</em> + <em>butes </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. + + -<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>p </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>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> + + +<HR> + +<H3 ALIGN="CENTER"> + Apache HTTP Server Version 1.3 +</H3> + +<A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A> +<A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A> + +</body></html> |