summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFabian Keil <fk@fabiankeil.de>2021-01-18 09:21:54 +0100
committerDaniel Stenberg <daniel@haxx.se>2021-02-09 08:16:40 +0100
commite6f4ab347706ba4aa6a804c5cdb364d2021c89bc (patch)
treecb054a70ed240e28773cabf88c3781a9bf573336
parent203dc007188b847bed698f9bca904365948d4cfb (diff)
downloadcurl-e6f4ab347706ba4aa6a804c5cdb364d2021c89bc.tar.gz
runtests.1: document -o, -P, -L, and -E
-rw-r--r--tests/runtests.123
1 files changed, 22 insertions, 1 deletions
diff --git a/tests/runtests.1 b/tests/runtests.1
index 582e8acec..f63bfae69 100644
--- a/tests/runtests.1
+++ b/tests/runtests.1
@@ -20,7 +20,7 @@
.\" *
.\" **************************************************************************
.\"
-.TH runtests.pl 1 "2 Feb 2010" "Curl 7.69.0" "runtests"
+.TH runtests.pl 1 "19 Jan 2021" "Curl 7.75.0" "runtests"
.SH NAME
runtests.pl \- run one or more test cases
.SH SYNOPSIS
@@ -60,6 +60,14 @@ Provide a path to a custom curl binary to run the tests with. Default is the
curl executable in the build tree.
.IP "-d"
Enable protocol debug: have the servers display protocol output.
+.IP "-E <exclude_file>"
+Load the \fBexclude_file\fP with additional reasons why certain tests
+should be skipped. Useful when testing with external HTTP proxies in
+which case some of the tests aren't appropriate.
+The file contains colon-delimited lines. The first field contains the
+type of exclusion, the second field contains a pattern and the final
+field contains the reason why matching tests should be skipped.
+The exclusion types are \fkeyword\fP, \ftest\fP, and \ftool\fP.
.IP "-e"
Run the test event-based (if possible). This will make runtests invoke curl
with --test-event option. This option only works if both curl and libcurl were
@@ -74,10 +82,23 @@ Displays a help text about this program's command line options.
.IP "-k"
Keep output and log files in log/ after a test run, even if no error was
detected. Useful for debugging.
+.IP "-L <file>"
+Load and execute the specified file which should contain perl code.
+This option allows to change \fIruntests.pl\fP behaviour by overwriting
+functions and variables and is useful when testing external proxies
+using curl's regression test suite.
.IP "-l"
Lists all test case names.
.IP "-n"
Disable the check for and use of valgrind.
+.IP "-o <variablename=value>"
+Overwrite the specified internal \fBvariable\fP with \fBvalue\fP.
+Useful to change variables that didn't get a dedicated flag to change them.
+Check the source to see which variables are available.
+.IP "-P <proxy>"
+Use the specified HTTP proxy when executing tests, even if the tests
+themselves don't specify a proxy. This option allows to test external
+proxies using curl's regression test suite.
.IP "-p"
Prints out all files in "log/" to stdout when a test case fails. Very
practical when used in the automated and distributed tests since then the