[prev in list] [next in list] [prev in thread] [next in thread]
List: apache-cvs
Subject: svn commit: r1842104 [1/8] - in /httpd/httpd/trunk/docs/man: ab.1 apachectl.8 apxs.1 ctlogconfig.8 d
From: jorton () apache ! org
Date: 2018-09-27 15:35:44
Message-ID: 20180927153545.779AA3A013F () svn01-us-west ! apache ! org
[Download RAW message or body]
Author: jorton
Date: Thu Sep 27 15:35:44 2018
New Revision: 1842104
URL: http://svn.apache.org/viewvc?rev=1842104&view=rev
Log:
Revert borked transforms.
Modified:
httpd/httpd/trunk/docs/man/ab.1
httpd/httpd/trunk/docs/man/apachectl.8
httpd/httpd/trunk/docs/man/apxs.1
httpd/httpd/trunk/docs/man/ctlogconfig.8
httpd/httpd/trunk/docs/man/dbmmanage.1
httpd/httpd/trunk/docs/man/fcgistarter.8
httpd/httpd/trunk/docs/man/firehose.1
httpd/httpd/trunk/docs/man/htcacheclean.8
httpd/httpd/trunk/docs/man/htdbm.1
httpd/httpd/trunk/docs/man/htdigest.1
httpd/httpd/trunk/docs/man/htpasswd.1
httpd/httpd/trunk/docs/man/httpd.8
httpd/httpd/trunk/docs/man/httxt2dbm.1
httpd/httpd/trunk/docs/man/logresolve.1
httpd/httpd/trunk/docs/man/rotatelogs.8
httpd/httpd/trunk/docs/man/suexec.8
Modified: httpd/httpd/trunk/docs/man/ab.1
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/ab.1?rev=1842104&r1=1842103&r2=1842104&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/man/ab.1 (original)
+++ httpd/httpd/trunk/docs/man/ab.1 Thu Sep 27 15:35:44 2018
@@ -1,216 +1,216 @@
-.\" XXXXXXXXXXXXX \
XXXXXXXXXXXXXXXXXXXXXXXXXX
-.\" DO NOT EDIT!  \
Generated from XML source.
-.\" XXXXXXXXXXXXX \
XXXXXXXXXXXXXXXXXXXXXXXXXX
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Verti	 \
9;al space (when & \
#119;e can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "AB" 1 "@dat \
01;@" "Apache HTTP Server" "ab"
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.\" DO NOT EDIT! Generated from XML source.
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "AB" 1 "2018-09-27" "Apache HTTP Server" "ab"
-.SH NAME
-ab \- Apache HTT&# \
80; server benchmarking tool
+.SH NAME
+ab \- Apache HTTP server benchmarking tool
-.SH "SYNOPSIS"
- 
-.PP
-\fB\fBab\fR [ -\&# \
102;BA\fR \fIauth-u& \
#115;ername\fR:\fIp	 \
7;ssword\fR ] [ -&# \
92;fBb\fR \fIwindo \
wsize\fR ] [ -\f \
;BB\fR \fIlocal-a \
ddress\fR ] [ -\ \
;fBc\fR \fIconcu \
4;rency\fR ] [ -\
 \
2;BC\fR \fIcookie-name\fR=\
fIvalue\fR ] [  \
5;\fBd\fR ] [ -\fB \
e\fR \fIcsv-fil \
01;\fR ] [ -\fBE\fR \
 \fIclient-cert&# \
105;ficate file\fR \
2;] [ -\fBf\fR \fI \
protocol\fR ] [ \
2;-\fBg\fR \fIgnu&# \
112;lot-file\fR ] [ \
; -\fBh\fR ] [ -\fBH\fR \fI&#
99;ustom-header\f \
R ] [ -\fBi\fR ] \
2;[ -\fBk\fR ] [ -& \
#92;fBl\fR ] [ -\fB \
09;\fR \fIHTTP-met \
04;od\fR ] [ -\fBn	 \
2;fR \fIrequests\ \
;fR ] [ -\fBp\fR & \
#92;fIPOST-file\fR & \
#93; [ -\fBP\fR \fI \
2;roxy-auth-username\fR:\f&
#73;password\fR ] &# \
91; -\fBq\fR ] [ -\ \
fBr\fR ] [ -\fBs& \
#92;fR \fItimeout\ \
02;R ] [ -\fBS\fR ]& \
#32;[ -\fBt\fR \fIt&# \
105;melimit\fR ] [  \
;-\fBT\fR \fIcont \
;ent-type\fR ] [&# \
32;-\fBu\fR \fIPUT- \
;file\fR ] [ -\fBv\fR \fIv
01;rbosity\fR] [ - \
;\fBV\fR ] [ -\fB&# \
119;\fR ] [ -\fBx\f \
2; \fI<table>-att \
14;ibutes\fR ] [ -&# \
92;fBX\fR \fIproxy \
\fR[:\fIport\fR] \
; ] [ -\fBy\fR \f& \
#73;<tr>-attribute \
15;\fR ] [ -\fBz\fR \
; \fI<td>-attributes\fR ] &
#91; -\fBZ\fR \fIci& \
#112;hersuite\fR ] &# \
91;http[s]://]\fIh& \
#111;stname\fR[:\fI \
2;ort\fR]/\fIpath\fR\fR
- 
+.SH "SYNOPSIS"
+
+.PP
+\fB\fBab\fR [ -\fBA\fR \fIauth-username\fR:\fIpassword\fR ] [ -\fBb\fR \
\fIwindowsize\fR ] [ -\fBB\fR \fIlocal-address\fR ] [ -\fBc\fR \fIconcurrency\fR ] [ \
-\fBC\fR \fIcookie-name\fR=\fIvalue\fR ] [ -\fBd\fR ] [ -\fBe\fR \fIcsv-file\fR ] [ \
-\fBE\fR \fIclient-certificate file\fR ] [ -\fBf\fR \fIprotocol\fR ] [ -\fBg\fR \
\fIgnuplot-file\fR ] [ -\fBh\fR ] [ -\fBH\fR \fIcustom-header\fR ] [ -\fBi\fR ] [ \
-\fBk\fR ] [ -\fBl\fR ] [ -\fBm\fR \fIHTTP-method\fR ] [ -\fBn\fR \fIrequests\fR ] [ \
-\fBp\fR \fIPOST-file\fR ] [ -\fBP\fR \fIproxy-auth-username\fR:\fIpassword\fR ] [ \
-\fBq\fR ] [ -\fBr\fR ] [ -\fBs\fR \fItimeout\fR ] [ -\fBS\fR ] [ -\fBt\fR \
\fItimelimit\fR ] [ -\fBT\fR \fIcontent-type\fR ] [ -\fBu\fR \fIPUT-file\fR ] [ \
-\fBv\fR \fIverbosity\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR \
\fI<table>-attributes\fR ] [ -\fBX\fR \fIproxy\fR[:\fIport\fR] ] [ -\fBy\fR \
\fI<tr>-attributes\fR ] [ -\fBz\fR \fI<td>-attributes\fR ] [ -\fBZ\fR \
\fIciphersuite\fR ] [http[s]://]\fIhostname\fR[:\fIport\fR]/\fI path\fR\fR
+
-.SH "SUMMARY"
- 
-.PP
-\fBab\fR is a to \
;ol for benchmar \
king your Apach& \
#101; Hypertext Tra&# \
110;sfer Protocol &# \
40;HTTP) server\&.&# \
32;It is designed&# \
32;to give you an \
2;impression of &# \
104;ow your curren& \
#116; Apache installation pe
14;forms\&. This  \
01;specially show&# \
115; you how many  \
14;equests per se& \
#99;ond your Apach \
01; installation  \
05;s capable of serving\&.
- 
+.SH "SUMMARY"
+
+.PP
+\fBab\fR is a tool for benchmarking your Apache Hypertext Transfer Protocol (HTTP) \
server\&. It is designed to give you an impression of how your current Apache \
installation performs\&. This especially shows you how many requests per second your \
Apache installation is capable of serving\&. +
-.SH "OPTIONS"
- 
- 
-.TP
-\fB-A \fIauth-u \
5;ername\fR:\fIpassword\fR\fR
-Supply BASIC Au \
6;hentication cr
 \
1;dentials to th \
01; server\&. The  \
username and pa& \
#115;sword are sepa& \
#114;ated by a sing \
08;e \fB:\fR and s&# \
101;nt on the wire& \
#32;base64 encoded\ \
;&. The string is sent re&
#103;ardless of wh
 \
1;ther the serve&# \
114; needs it (\fI
 \
5;\&.e\&.\fR, has  \
sent an 401 aut
 \
4;entication needed)\&.  
-.TP
-\fB-b \fIwindowsize\fR\fR
-Size of TCP sen&# \
100;/receive buffe&# \
114;, in bytes\&.  
-.TP
-\fB-B \fIlocal-address\fR\fR
-Address to bind \
; to when making \
; outgoing connections\&.  
-.TP
-\fB-c \fIconcurrency\fR\fR
-Number of multi \
;ple requests t \
11; perform at a t \
;ime\&. Default &# \
105;s one request at a time\&.  
-.TP
-\fB-C \fIcookie \
5;name\fR=\fIvalue\fR\fR
-Add a \fBCookie&# \
58;\fR line to th
 \
1; request\&. The \
 argument is ty \
pically in the & \
#102;orm of a \fB\fI \
;name\fR=\fIvalu&# \
101;\fR\fR pair\&. &# \
84;his field is repeatable\&.  
-.TP
-\fB-d\fR
-Do not display  \
the "percentage \
 served within  \
;XX [ms] table"\& \
. (legacy support)\&.  
-.TP
-\fB-e \fIcsv-file\fR\fR
-Write a Comma s&# \
101;parated value  \
0;CSV) file which& \
#32;contains for e&# \
97;ch percentage ( \
;from 1% to 100%) \
; the time (in m \
illiseconds) it \
; took to serve  \
;that percentage \
; of the requests\&. This&
#32;is usually mor \
;e useful than t \
;he 'gnuplot' fi \
;le; as the resu \
lts are already 'binned'\&.  
-.TP
-\fB-E \fIclient \
5;certificate-file\fR\fR
-When connecting \
; to an SSL webs
 \
5;te, use the pr \
1;vided client c
 \
1;rtificate in PE \
M format to aut&# \
104;enticate with &# \
116;he server\&. T
 \
4;e file is expe	 \
9;ted to contain  \
;the client certificate, &
#102;ollowed by in \
6;ermediate cert \
05;ficates, follo \
19;ed by the priv	 \
7;te key\&. Avail& \
#97;ble in 2\&.4\&. \
1;6 and later\&.  
-.TP
-\fB-f \fIprotocol\fR\fR
-Specify SSL/TLS  \
protocol (SSL2,  \
;SSL3, TLS1, TLS1\ \
&.1, TLS1\&.2, or \
; ALL)\&. TLS1\&.1 \
 and TLS1\&.2 su&# \
112;port available \
2;in 2\&.4\&.4 and later\&.  
-.TP
-\fB-g \fIgnuplot-file\fR\fR
-Write all measu \
red values out  \
as a 'gnuplot'  \
11;r TSV (Tab sepa \
4;ate values) fil \
;e\&. This file &# \
99;an easily be im \
;ported into pac \
;kages like Gnup \
;lot, IDL, Mathe
 \
9;atica, Igor or even Exce
08;\&. The labels  \
are on the firs \
t line of the file\&.  
-.TP
-\fB-h\fR
-Display usage i \
nformation\&.  
-.TP
-\fB-H \fIcustom-header\fR\fR
-Append extra he \
;aders to the re \
;quest\&. The ar&# \
103;ument is typic& \
#97;lly in the for& \
#109; of a valid he	 \
7;der line, conta \
;ining a colon-s \
eparated field- \
value pair (\fI \
05;\&.e\&.\fR, \fB"Accept-En	
9;oding: zip/zop;8bit"\fR)\&.  
-.TP
-\fB-i\fR
-Do \fBHEAD\fR re \
quests instead  \
;of \fBGET\fR\&.  
-.TP
-\fB-k\fR
-Enable the HTTP  \
;KeepAlive featu \
;re, \fIi\&.e\&.\ \
fR, perform mul \
tiple requests \
2;within one HTTP \
 session\&. Def&# \
97;ult is no KeepAlive\&.  
-.TP
-\fB-l\fR
-Do not report e \
;rrors if the l
 \
1;ngth of the re \
15;ponses is not &# \
99;onstant\&. This \
; can be useful &# \
102;or dynamic pag \
01;s\&. Available &# \
105;n 2\&.4\&.7 and later\&.  
-.TP
-\fB-m \fIHTTP-method\fR\fR
-Custom HTTP met&# \
104;od for the req& \
#117;ests\&. Availab \
;le in 2\&.4\&.10 and later\&.  
-.TP
-\fB-n \fIrequests\fR\fR
-Number of reque \
;sts to perform \
2;for the benchma \
;rking session\ \
8;. The default i \
s to just perfo \
;rm a single req \
;uest which usua \
;lly leads to no \
;n-representati \
18;e benchmarking results\
8;.  
-.TP
-\fB-p \fIPOST-file\fR\fR
-File containing \
; data to POST\&.& \
#32;Remember to al \
15;o set \fB-T\fR\&.  
-.TP
-\fB-P \fIproxy-	 \
7;uth-username\f \
2;:\fIpassword\fR\fR
-Supply BASIC Au \
6;hentication cr
 \
1;dentials to a p \
;roxy en-route\& \
;. The username & \
#97;nd password ar&# \
101; separated by a \
; single \fB:\fR&# \
32;and sent on th \
01; wire base64 en \
coded\&. The string is s
01;nt regardless  \
of whether the  \
;proxy needs it \
2;(\fIi\&.e\&.\fR, \
 has sent an 407 \
; proxy authent
 \
5;cation needed)\&.  
-.TP
-\fB-q\fR
-When processin
 \
3; more than 150 &# \
114;equests, \fBab\ \
;fR outputs a pr \
ogress count on \
; \fBstderr\fR e& \
#118;ery 10% or 100 & \
#114;equests or so\ \
&. The \fB-q\fR & \
#102;lag will suppr \
ess these messages\&.  
-.TP
-\fB-r\fR
-Don't exit on s \
ocket receive errors\&.  
-.TP
-\fB-s \fItimeout\fR\fR
-Maximum number  \
of seconds to w \
ait before the & \
#115;ocket times ou \
t\&. Default is \
2;30 seconds\&. A \
18;ailable in 2\&.&# \
52;\&.4 and later\&.  
-.TP
-\fB-S\fR
-Do not display  \
the median and & \
#115;tandard deviat& \
#105;on values, nor& \
#32;display the wa&# \
114;ning/error mes \
sages when the  \
average and med& \
#105;an are more th&# \
97;n one or two t \
05;mes the standard deviat
05;on apart\&. And \
; default to the \
; min/avg/max va&# \
108;ues\&. (legacy support)\&.  
-.TP
-\fB-t \fItimelimit\fR\fR
-Maximum number  \
of seconds to s \
pend for benchm \
arking\&. This  \
05;mplies a \fB-n  \
50000\fR interna \
;lly\&. Use this& \
#32;to benchmark t \
04;e server withi& \
#110; a fixed total&# \
32;amount of time\&. Per de
fault there is \
2;no timelimit\&.  
-.TP
-\fB-T \fIcontent-type\fR\fR
-Content-type h
 \
1;ader to use fo \
4; POST/PUT data, &# \
101;g\&. \fBapplica& \
#116;ion/x-www-form \
-urlencoded\fR\& \
#38;. Default is \f \
;Btext/plain\fR\&.  
-.TP
-\fB-u \fIPUT-file\fR\fR
-File containing \
; data to PUT\&. & \
#82;emember to als&# \
111; set \fB-T\fR\&.  
-.TP
-\fB-v \fIverbosity\fR\fR
-Set verbosity l \
;evel - \fB4\fR a \
;nd above prints \
; information o \
0; headers, \fB3\&# \
102;R and above pri \
;nts response c \
1;des (404, 200, e \
tc\&.), \fB2\fR 	 \
7;nd above print \
5; warnings and info\&.  
-.TP
-\fB-V\fR
-Display versio \
0; number and exit\&.  
-.TP
-\fB-w\fR
-Print out resu
 \
8;ts in HTML tabl \
01;s\&. Default ta& \
#98;le is two colu&# \
109;ns wide, with &# \
97; white background\&.  
-.TP
-\fB-x \fI<table> \
;-attributes\fR\fR
-String to use a \
s attributes fo \
r \fB<table>\fR\ \
&. Attributes a \
14;e inserted \fB \
0;table \fIhere\fR >\fR\&.  
-.TP
-\fB-X \fIproxy\ \
02;R[:\fIport\fR]\fR
-Use a proxy ser \
ver for the requests\&.  
-.TP
-\fB-y \fI<tr>-attributes\fR\fR
-String to use a \
s attributes fo \
r \fB<tr>\fR\&.  
-.TP
-\fB-z \fI<td>-attributes\fR\fR
-String to use a \
s attributes fo \
r \fB<td>\fR\&.  
-.TP
-\fB-Z \fIciphersuite\fR\fR
-Specify SSL/TLS  \
cipher suite (S& \
#101;e openssl ciphers)  
- 
-.SH "OUTPUT"
- 
-.PP
-The following 
 \
8;ist describes  \
6;he values retu \
14;ned by \fBab\fR:
- 
- 
-.TP
-Server Software
-The value, if a&# \
110;y, returned in& \
#32;the \fIserver\&# \
102;R HTTP header o& \
#102; the first suc& \
#99;essful respons \
;e\&. This inclu&# \
100;es all characte \
;rs in the heade \
;r from beginni \
0;g to the point a charact&#
101;r with decimal \
 value of 32 (m \
1;st notably: a s& \
#112;ace or CR/LF) i&# \
115; detected\&.  
-.TP
-Server Hostname
-The DNS or IP ad \
dress given on  \
;the command line  
-.TP
-Server Port
-The port to whi \
;ch ab is connec \
16;ing\&. If no po \
rt is given on  \
the command lin \
e, this will de \
fault to 80 for&# \
32;http and 443 for https\&.  
-.TP
-SSL/TLS Protocol
-The protocol pa \
rameters negot
 \
5;ated between t
 \
4;e client and se \
;rver\&. This wi& \
#108;l only be prin& \
#116;ed if SSL is used\&.  
-.TP
-Document Path
-The request URI& \
#32;parsed from th& \
#101; command line string\&.  
-.TP
-Document Length
-This is the siz \
;e in bytes of t \
he first succes \
sfully returne \
00; document\&. If \
 the document l \
ength changes d \
uring testing,  \
;the response i \
15; considered an error\&.  
-.TP
-Concurrency Level
-The number of c& \
#111;ncurrent clien \
ts used during the test  
-.TP
-Time taken for tests
-This is the tim \
;e taken from th \
;e moment the f
 \
5;rst socket con \
0;ection is creat \
;ed to the mome \
0;t the last res \
2;onse is received  
-.TP
-Complete requests
-The number of s \
uccessful respo \
;nses received  
-.TP
-Failed requests
-The number of r \
equests that we \
;re considered a \
; failure\&. If  \
16;he number is g \
14;eater than zer \
11;, another line \
2;will be printe \
00; showing the n&# \
117;mber of reques& \
#116;s that failed due to co
10;necting, readi& \
#110;g, incorrect c \
11;ntent length, &# \
111;r exceptions\&.  
-.TP
-Write errors
-The number of e \
rrors that fail \
ed during writ
 \
1; (broken pipe)\&.  
-.TP
-Non-2xx responses
-The number of r \
esponses that w \
;ere not in the  \
;200 series of r& \
#101;sponse codes\&& \
#46; If all respon \
15;es were 200, th \
is field is not printed\&.  
-.TP
-Keep-Alive requests
-The number of c& \
#111;nnections that \
 resulted in Ke \
ep-Alive requests  
-.TP
-Total body sent
-If configured t \
;o send data as &# \
112;art of the tes&# \
116;, this is the  \
16;otal number of \
2;bytes sent dur \
05;ng the tests\& \
6; This field is  \
;omitted if the \
2;test did not i \
10;clude a body to send\&. &#
32;
-.TP
-Total transferred
-The total numbe \
r of bytes rece& \
#105;ved from the s \
erver\&. This n&# \
117;mber is essent& \
#105;ally the numbe& \
#114; of bytes sent& \
#32;over the wire\&.  
-.TP
-HTML transferred
-The total numbe \
r of document b& \
#121;tes received f \
rom the server\ \
;&. This number &# \
101;xcludes bytes &# \
114;eceived in HTTP headers  
-.TP
-Requests per second
-This is the num \
;ber of request \
5; per second\&. & \
#84;his value is t&# \
104;e result of di& \
#118;iding the numb \
er of requests  \
;by the total time taken  
-.TP
-Time per request
-The average tim \
e spent per req \
;uest\&. The fir& \
#115;t value is cal	 \
9;ulated with th \
01; formula \fBcon \
;currency * time \
taken * 1000 / d& \
#111;ne\fR while th& \
#101; second value &# \
105;s calculated with the f
1;rmula \fBtimet&# \
97;ken * 1000 / done\fR  
-.TP
-Transfer rate
-The rate of tra& \
#110;sfer as calcul	 \
7;ted by the for
 \
9;ula \fBtotalrea \
d / 1024 / timetaken\fR  
- 
-.SH "BUGS"
- 
-.PP
-There are vario \
us statically d& \
#101;clared buffers& \
#32;of fixed lengt \
h\&. Combined w \
05;th the lazy pa \
4;sing of the co
 \
9;mand line argu
 \
9;ents, the resp \
11;nse headers fr&# \
111;m the server and other &#
101;xternal input \
5;, this might bite you\&.
- 
-.PP
-It does not imp \
;lement HTTP/1\&. \
;x fully; only a \
ccepts some 'ex& \
#112;ected' forms o& \
#102; responses\&. &# \
84;he rather heav \
21; use of \fBstr \
5;tr(3)\fR shows & \
#117;p top in profi \
le, which might indicate&
#32;a performance & \
#112;roblem; \fIi\&. \
;e\&.\fR, you wo \
17;ld measure the&# \
32;\fBab\fR perfor \
mance rather th& \
#97;n the server's\&.
- 
+.SH "OPTIONS"
+
+
+.TP
+\fB-A \fIauth-username\fR:\fIpassword\fR\fR
+Supply BASIC Authentication credentials to the server\&. The username and password \
are separated by a single \fB:\fR and sent on the wire base64 encoded\&. The string \
is sent regardless of whether the server needs it (\fIi\&.e\&.\fR, has sent an 401 \
authentication needed)\&. +.TP
+\fB-b \fIwindowsize\fR\fR
+Size of TCP send/receive buffer, in bytes\&.
+.TP
+\fB-B \fIlocal-address\fR\fR
+Address to bind to when making outgoing connections\&.
+.TP
+\fB-c \fIconcurrency\fR\fR
+Number of multiple requests to perform at a time\&. Default is one request at a \
time\&. +.TP
+\fB-C \fIcookie-name\fR=\fIvalue\fR\fR
+Add a \fBCookie:\fR line to the request\&. The argument is typically in the form of \
a \fB\fIname\fR=\fIvalue\fR\fR pair\&. This field is repeatable\&. +.TP
+\fB-d\fR
+Do not display the "percentage served within XX [ms] table"\&. (legacy support)\&.
+.TP
+\fB-e \fIcsv-file\fR\fR
+Write a Comma separated value (CSV) file which contains for each percentage (from 1% \
to 100%) the time (in milliseconds) it took to serve that percentage of the \
requests\&. This is usually more useful than the 'gnuplot' file; as the results are \
already 'binned'\&. +.TP
+\fB-E \fIclient-certificate-file\fR\fR
+When connecting to an SSL website, use the provided client certificate in PEM format \
to authenticate with the server\&. The file is expected to contain the client \
certificate, followed by intermediate certificates, followed by the private key\&. \
Available in 2\&.4\&.36 and later\&. +.TP
+\fB-f \fIprotocol\fR\fR
+Specify SSL/TLS protocol (SSL2, SSL3, TLS1, TLS1\&.1, TLS1\&.2, or ALL)\&. TLS1\&.1 \
and TLS1\&.2 support available in 2\&.4\&.4 and later\&. +.TP
+\fB-g \fIgnuplot-file\fR\fR
+Write all measured values out as a 'gnuplot' or TSV (Tab separate values) file\&. \
This file can easily be imported into packages like Gnuplot, IDL, Mathematica, Igor \
or even Excel\&. The labels are on the first line of the file\&. +.TP
+\fB-h\fR
+Display usage information\&.
+.TP
+\fB-H \fIcustom-header\fR\fR
+Append extra headers to the request\&. The argument is typically in the form of a \
valid header line, containing a colon-separated field-value pair (\fIi\&.e\&.\fR, \
\fB"Accept-Encoding: zip/zop;8bit"\fR)\&. +.TP
+\fB-i\fR
+Do \fBHEAD\fR requests instead of \fBGET\fR\&.
+.TP
+\fB-k\fR
+Enable the HTTP KeepAlive feature, \fIi\&.e\&.\fR, perform multiple requests within \
one HTTP session\&. Default is no KeepAlive\&. +.TP
+\fB-l\fR
+Do not report errors if the length of the responses is not constant\&. This can be \
useful for dynamic pages\&. Available in 2\&.4\&.7 and later\&. +.TP
+\fB-m \fIHTTP-method\fR\fR
+Custom HTTP method for the requests\&. Available in 2\&.4\&.10 and later\&.
+.TP
+\fB-n \fIrequests\fR\fR
+Number of requests to perform for the benchmarking session\&. The default is to just \
perform a single request which usually leads to non-representative benchmarking \
results\&. +.TP
+\fB-p \fIPOST-file\fR\fR
+File containing data to POST\&. Remember to also set \fB-T\fR\&.
+.TP
+\fB-P \fIproxy-auth-username\fR:\fIpassword\fR\fR
+Supply BASIC Authentication credentials to a proxy en-route\&. The username and \
password are separated by a single \fB:\fR and sent on the wire base64 encoded\&. The \
string is sent regardless of whether the proxy needs it (\fIi\&.e\&.\fR, has sent an \
407 proxy authentication needed)\&. +.TP
+\fB-q\fR
+When processing more than 150 requests, \fBab\fR outputs a progress count on \
\fBstderr\fR every 10% or 100 requests or so\&. The \fB-q\fR flag will suppress these \
messages\&. +.TP
+\fB-r\fR
+Don't exit on socket receive errors\&.
+.TP
+\fB-s \fItimeout\fR\fR
+Maximum number of seconds to wait before the socket times out\&. Default is 30 \
seconds\&. Available in 2\&.4\&.4 and later\&. +.TP
+\fB-S\fR
+Do not display the median and standard deviation values, nor display the \
warning/error messages when the average and median are more than one or two times the \
standard deviation apart\&. And default to the min/avg/max values\&. (legacy \
support)\&. +.TP
+\fB-t \fItimelimit\fR\fR
+Maximum number of seconds to spend for benchmarking\&. This implies a \fB-n 50000\fR \
internally\&. Use this to benchmark the server within a fixed total amount of time\&. \
Per default there is no timelimit\&. +.TP
+\fB-T \fIcontent-type\fR\fR
+Content-type header to use for POST/PUT data, eg\&. \
\fBapplication/x-www-form-urlencoded\fR\&. Default is \fBtext/plain\fR\&. +.TP
+\fB-u \fIPUT-file\fR\fR
+File containing data to PUT\&. Remember to also set \fB-T\fR\&.
+.TP
+\fB-v \fIverbosity\fR\fR
+Set verbosity level - \fB4\fR and above prints information on headers, \fB3\fR and \
above prints response codes (404, 200, etc\&.), \fB2\fR and above prints warnings and \
info\&. +.TP
+\fB-V\fR
+Display version number and exit\&.
+.TP
+\fB-w\fR
+Print out results in HTML tables\&. Default table is two columns wide, with a white \
background\&. +.TP
+\fB-x \fI<table>-attributes\fR\fR
+String to use as attributes for \fB<table>\fR\&. Attributes are inserted \fB<table \
\fIhere\fR >\fR\&. +.TP
+\fB-X \fIproxy\fR[:\fIport\fR]\fR
+Use a proxy server for the requests\&.
+.TP
+\fB-y \fI<tr>-attributes\fR\fR
+String to use as attributes for \fB<tr>\fR\&.
+.TP
+\fB-z \fI<td>-attributes\fR\fR
+String to use as attributes for \fB<td>\fR\&.
+.TP
+\fB-Z \fIciphersuite\fR\fR
+Specify SSL/TLS cipher suite (See openssl ciphers)
+
+.SH "OUTPUT"
+
+.PP
+The following list describes the values returned by \fBab\fR:
+
+
+.TP
+Server Software
+The value, if any, returned in the \fIserver\fR 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\&. \
+.TP +Server Hostname
+The DNS or IP address given on the command line
+.TP
+Server Port
+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\&. +.TP
+SSL/TLS Protocol
+The protocol parameters negotiated between the client and server\&. This will only \
be printed if SSL is used\&. +.TP
+Document Path
+The request URI parsed from the command line string\&.
+.TP
+Document Length
+This is the size in bytes of the first successfully returned document\&. If the \
document length changes during testing, the response is considered an error\&. +.TP
+Concurrency Level
+The number of concurrent clients used during the test
+.TP
+Time taken for tests
+This is the time taken from the moment the first socket connection is created to the \
moment the last response is received +.TP
+Complete requests
+The number of successful responses received
+.TP
+Failed requests
+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\&. +.TP
+Write errors
+The number of errors that failed during write (broken pipe)\&.
+.TP
+Non-2xx responses
+The number of responses that were not in the 200 series of response codes\&. If all \
responses were 200, this field is not printed\&. +.TP
+Keep-Alive requests
+The number of connections that resulted in Keep-Alive requests
+.TP
+Total body sent
+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\&. +.TP
+Total transferred
+The total number of bytes received from the server\&. This number is essentially the \
number of bytes sent over the wire\&. +.TP
+HTML transferred
+The total number of document bytes received from the server\&. This number excludes \
bytes received in HTTP headers +.TP
+Requests per second
+This is the number of requests per second\&. This value is the result of dividing \
the number of requests by the total time taken +.TP
+Time per request
+The average time spent per request\&. The first value is calculated with the formula \
\fBconcurrency * timetaken * 1000 / done\fR while the second value is calculated with \
the formula \fBtimetaken * 1000 / done\fR +.TP
+Transfer rate
+The rate of transfer as calculated by the formula \fBtotalread / 1024 / timetaken\fR \
+
+.SH "BUGS"
+
+.PP
+There are various statically declared buffers of fixed length\&. Combined with the \
lazy parsing of the command line arguments, the response headers from the server and \
other external inputs, this might bite you\&. +
+.PP
+It does not implement HTTP/1\&.x fully; only accepts some 'expected' forms of \
responses\&. The rather heavy use of \fBstrstr(3)\fR shows up top in profile, which \
might indicate a performance problem; \fIi\&.e\&.\fR, you would measure the \fBab\fR \
performance rather than the server's\&. +
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic