diff options
author | Fabian Keil <fk@fabiankeil.de> | 2021-01-18 09:21:54 +0100 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2021-02-09 08:16:40 +0100 |
commit | e6f4ab347706ba4aa6a804c5cdb364d2021c89bc (patch) | |
tree | cb054a70ed240e28773cabf88c3781a9bf573336 | |
parent | 203dc007188b847bed698f9bca904365948d4cfb (diff) | |
download | curl-e6f4ab347706ba4aa6a804c5cdb364d2021c89bc.tar.gz |
runtests.1: document -o, -P, -L, and -E
-rw-r--r-- | tests/runtests.1 | 23 |
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 |