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

diff --git a/docs/man/ab.8 b/docs/man/ab.8
index aa1c7ab2d54343184eb524d844520d4fc4e7e45a..7e6c03ece7133248e9b4b43a030811ed921cb1a3 100644 (file)
--- a/docs/man/ab.8
+++ b/docs/man/ab.8
@@ -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\&.  

diff --git a/docs/manual/programs/ab.html.en b/docs/manual/programs/ab.html.en
index 446c2478a626ded958afc9c903950a08ca4c8af1..89faafb2750f34461d47dc01c41814dc0b47fd3f 100644 (file)
--- a/docs/manual/programs/ab.html.en
+++ b/docs/manual/programs/ab.html.en
@@ -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

diff --git a/docs/manual/programs/ab.xml b/docs/manual/programs/ab.xml
index e42c6664caeca32facde293273921b19ad3435b7..2810e9e834033d98db7315773ff4283ecfedfc85 100644 (file)
--- a/docs/manual/programs/ab.xml
+++ b/docs/manual/programs/ab.xml
@@ -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

diff --git a/support/ab.c b/support/ab.c
index 7694a95cf94f8056bcc5213552ddcc4e240e9597..3e1029509613c7347516b491b6fc3af87ff3aa61 100644 (file)
--- a/support/ab.c
+++ b/support/ab.c
@@ -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");