Commit bf017abd authored by Sander Temme's avatar Sander Temme
Browse files

Explain that POST data should be sent as the correct MIME type. 

Submitted by Vincent Bray noodlet at gmail dot com, 
edited and reviewed by sctemme


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@541138 13f79535-47bb-0310-9956-ffa450edef68
parent c1d9d931

docs/man/ab.8

+3 −3
Original line number Diff line number Diff line
@@ -19,7 +19,7 @@ 
.el .ne 3

.IP "\\$1" \\$2

..

.TH "AB" 8 "2004-11-14" "Apache HTTP Server" "ab"

.TH "AB" 8 "2007-05-22" "Apache HTTP Server" "ab"



.SH NAME

ab \- Apache HTTP server benchmarking tool
@@ -74,7 +74,7 @@ Enable the HTTP KeepAlive feature, \fIi\&.e\&.\fR, perform multiple requests wit 
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

-p \fIPOST-file\fR

File containing data to POST\&.  

File containing data to POST\&. Remember to also set -T\&.  

.TP

-P \fIproxy-auth-username\fR:\fIpassword\fR

Supply BASIC Authentication credentials to a proxy en-route\&. The username and password are separated by a single : 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)\&.
@@ -92,7 +92,7 @@ Do not display the median and standard deviation values, nor display the warning 
Maximum number of seconds to spend for benchmarking\&. This implies a -n 50000 internally\&. Use this to benchmark the server within a fixed total amount of time\&. Per default there is no timelimit\&.  

.TP

-T \fIcontent-type\fR

Content-type header to use for POST data\&.  

Content-type header to use for POST data, eg\&. application/x-www-form-urlencoded\&. Default: text/plain\&.  

.TP

-v \fIverbosity\fR

Set verbosity level - 4 and above prints information on headers, 3 and above prints response codes (404, 200, etc\&.), 2 and above prints warnings and info\&.

docs/manual/programs/ab.html.en

+4 −2
Original line number Diff line number Diff line
@@ -118,7 +118,7 @@ 
    non-representative benchmarking results.</dd>



    <dt><code>-p <var>POST-file</var></code></dt>

    <dd>File containing data to POST.</dd>

    <dd>File containing data to POST.  Remember to also set <code>-T</code>.</dd>



    <dt><code>-P <var>proxy-auth-username</var>:<var>password</var></code></dt>

    <dd>Supply BASIC Authentication credentials to a proxy en-route. The
@@ -150,7 +150,9 @@ 
    fixed total amount of time. Per default there is no timelimit.</dd>



    <dt><code>-T <var>content-type</var></code></dt>

    <dd>Content-type header to use for POST data.</dd>

    <dd>Content-type header to use for POST data, eg.

    <code>application/x-www-form-urlencoded</code>.  

    Default: <code>text/plain</code>.</dd>



    <dt><code>-v <var>verbosity</var></code></dt>

    <dd>Set verbosity level - <code>4</code> and above prints information on

docs/manual/programs/ab.xml

+4 −2
Original line number Diff line number Diff line
@@ -118,7 +118,7 @@ 
    non-representative benchmarking results.</dd>



    <dt><code>-p <var>POST-file</var></code></dt>

    <dd>File containing data to POST.</dd>

    <dd>File containing data to POST.  Remember to also set <code>-T</code>.</dd>



    <dt><code>-P <var>proxy-auth-username</var>:<var>password</var></code></dt>

    <dd>Supply BASIC Authentication credentials to a proxy en-route. The
@@ -150,7 +150,9 @@ 
    fixed total amount of time. Per default there is no timelimit.</dd>



    <dt><code>-T <var>content-type</var></code></dt>

    <dd>Content-type header to use for POST data.</dd>

    <dd>Content-type header to use for POST data, eg.

    <code>application/x-www-form-urlencoded</code>.  

    Default: <code>text/plain</code>.</dd>



    <dt><code>-v <var>verbosity</var></code></dt>

    <dd>Set verbosity level - <code>4</code> and above prints information on

support/ab.c

+6 −2
Original line number Diff line number Diff line
@@ -1823,13 +1823,17 @@ static void usage(const char *progname) 
        "[s]"

#endif

        "://]hostname[:port]/path\n", progname);

/* 80 column ruler:  ********************************************************************************

 */

    fprintf(stderr, "Options are:\n");

    fprintf(stderr, "    -n requests     Number of requests to perform\n");

    fprintf(stderr, "    -c concurrency  Number of multiple requests to make\n");

    fprintf(stderr, "    -t timelimit    Seconds to max. wait for responses\n");

    fprintf(stderr, "    -b windowsize   Size of TCP send/receive buffer, in bytes\n");

    fprintf(stderr, "    -p postfile     File containing data to POST\n");

    fprintf(stderr, "    -T content-type Content-type header for POSTing\n");

    fprintf(stderr, "    -p postfile     File containing data to POST. Remember also to set -T\n");

    fprintf(stderr, "    -T content-type Content-type header for POSTing, eg.\n");

    fprintf(stderr, "                    'application/x-www-form-urlencoded'\n");

    fprintf(stderr, "                    Default is 'text/plain'\n");

    fprintf(stderr, "    -v verbosity    How much troubleshooting info to print\n");

    fprintf(stderr, "    -w              Print out results in HTML tables\n");

    fprintf(stderr, "    -i              Use HEAD instead of GET\n");