ab.html revision 2eaf662cbc81e823e8d9aeb8d54e69e63032493e
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <meta name="generator" content="HTML Tidy, see www.w3.org" />
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <title>Manual Page: ab - Apache HTTP Server</title>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <body bgcolor="#ffffff" text="#000000" link="#0000ff"
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <!--#include virtual="header.html" -->
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <!-- This document was autogenerated from the man page -->
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ab - Apache HTTP server benchmarking tool
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <strong>ab</strong> [ -<strong>k</strong> ] [ -<strong>n</strong> <em>requests</em> ] [ -<strong>t</strong> <em>timelimit</em> ] [ -<strong>c</strong> <em>concurrency</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ] [ -<strong>p</strong> <em>POST file</em> ] [ -<strong>A</strong> <em>Authentication username</em>:<em>password</em> ] [
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>P</strong> <em>Proxy Authentication username</em>:<em>password</em> ] [ -<strong>H</strong> <em>Custom</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <em>header</em> ] [ -<strong>C</strong> <em>Cookie name</em>=<em>value</em> ] [ -<strong>T</strong> <em>content</em>-<em>type</em> ] [ -<strong>v</strong>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <em>verbosity</em> ] ] [ -<strong>w</strong> <em>output HTML</em> ] ] [ -<strong>x</strong> <<em>table</em>> <em>attributes</em> ]
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ] [ -<strong>y</strong> <<em>tr</em>> <em>attributes</em> ] ] [ -<strong>z</strong> <<em>td</em>> <em>attributes</em> ]
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte [<em>http</em>://]<em>hostname</em>[:<em>port</em>]/<em>path</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <strong>ab</strong> [ -<strong>V</strong> ] [ -<strong>h</strong> ]
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <strong>ab</strong> is a tool for benchmarking your Apache HyperText Transfer
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Protocol (HTTP) server. It is designed to give you an
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte impression of how your current Apache installation performs.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte This especially shows you how many requests per second your
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Apache installation is capable of serving.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>k </strong> Enable the HTTP KeepAlive feature, i.e., perform
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte multiple requests within one HTTP session.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Default is no KeepAlive.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>n</strong> <em>requests</em> Number of requests to perform for the benchmark-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ing session. The default is to just perform a
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte single request which usually leads to non-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte representative benchmarking results.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Maximum number of seconds to spend for bench-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte marking. This implies a -<strong>n 50000</strong> internally. Use
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte this to benchmark the server within a fixed
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte total amount of time. Per default there is no
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Number of multiple requests to perform at a
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte time. Default is one request at a time.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte File containing data to POST.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>A</strong> <em>Authentication username</em>:<em>password</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Supply BASIC Authentication credentials to the
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte server. The username and password are separated
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte by a single ':' and sent on the wire uuencoded.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte The string is sent regardless of whether the
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte server needs it; (i.e., has sent an 401 authen-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte tication needed).
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>p</strong> <em>Proxy</em>-<em>Authentication username</em>:<em>password</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Supply BASIC Authentication credentials to a
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte proxy en-route. The username and password are
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte separated by a single ':' and sent on the wire
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte uuencoded. The string is sent regardless of
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte whether the proxy needs it; (i.e., has sent an
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte 407 proxy authentication needed).
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>C</strong> <em>Cookie name</em>=<em>value</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Add a 'Cookie:' line to the request. The argu-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ment is typically in the form of a 'name=value'
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte pair. This field is repeatable.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Append extra headers to the request. The argu-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ment is typically in the form of a valid header
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte line, containing a colon-separated field-value
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>T</strong> <em>content</em>-<em>type</em>
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte Content-type header to use for POST data.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>v </strong> Set verbosity level - 4 and above prints infor-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte mation on headers, 3 and above prints response
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte codes (404, 200, etc.), 2 and above prints warn-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ings and info.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>w </strong> Print out results in HTML tables. Default table
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte is two columns wide, with a white background.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte String to use as attributes for <table>. Attri-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte butes are inserted <table <strong>here</strong> >
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte String to use as attributes for <tr>.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte String to use as attributes for <td>.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte -<strong>V </strong> Display version number and exit.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte There are various statically declared buffers of fixed
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte length. Combined with the lazy parsing of the command line
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte arguments, the response headers from the server and other
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte external inputs, this might bite you.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte It does not implement HTTP/1.x fully; only accepts some
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte 'expected' forms of responses. The rather heavy use of
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <strong>strstr(3)</strong> shows up top in profile, which might indicate a
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte performance problem; i.e., you would measure the <strong>ab</strong> perfor-
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte mance rather than the server's.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte <!--#include virtual="footer.html" -->