From fb5c8b941ccebd7398d9ccd4bad2eed81bc9cae2 Mon Sep 17 00:00:00 2001 From: Sander Temme Date: Thu, 24 May 2007 02:19:04 +0000 Subject: [PATCH] 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 --- docs/man/ab.8 | 6 +++--- docs/manual/programs/ab.html.en | 6 ++++-- docs/manual/programs/ab.xml | 6 ++++-- support/ab.c | 8 ++++++-- 4 files changed, 17 insertions(+), 9 deletions(-) diff --git a/docs/man/ab.8 b/docs/man/ab.8 index aa1c7ab2d5..7e6c03ece7 100644 --- 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 446c2478a6..89faafb275 100644 --- a/docs/manual/programs/ab.html.en +++ b/docs/manual/programs/ab.html.en @@ -118,7 +118,7 @@ non-representative benchmarking results.
-p POST-file
-
File containing data to POST.
+
File containing data to POST. Remember to also set -T.
-P proxy-auth-username:password
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.
-T content-type
-
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.
-v verbosity
Set verbosity level - 4 and above prints information on diff --git a/docs/manual/programs/ab.xml b/docs/manual/programs/ab.xml index e42c6664ca..2810e9e834 100644 --- a/docs/manual/programs/ab.xml +++ b/docs/manual/programs/ab.xml @@ -118,7 +118,7 @@ non-representative benchmarking results.
-p POST-file
-
File containing data to POST.
+
File containing data to POST. Remember to also set -T.
-P proxy-auth-username:password
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.
-T content-type
-
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.
-v verbosity
Set verbosity level - 4 and above prints information on diff --git a/support/ab.c b/support/ab.c index 7694a95cf9..3e10295096 100644 --- 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"); -- 2.40.0