diff options
Diffstat (limited to 'Utilities/cmcurl-7.19.0/tests/runtests.1')
| -rw-r--r-- | Utilities/cmcurl-7.19.0/tests/runtests.1 | 104 |
1 files changed, 0 insertions, 104 deletions
diff --git a/Utilities/cmcurl-7.19.0/tests/runtests.1 b/Utilities/cmcurl-7.19.0/tests/runtests.1 deleted file mode 100644 index c09741c..0000000 --- a/Utilities/cmcurl-7.19.0/tests/runtests.1 +++ /dev/null @@ -1,104 +0,0 @@ -.\" ************************************************************************** -.\" * _ _ ____ _ -.\" * Project ___| | | | _ \| | -.\" * / __| | | | |_) | | -.\" * | (__| |_| | _ <| |___ -.\" * \___|\___/|_| \_\_____| -.\" * -.\" * Copyright (C) 1998 - 2007, Daniel Stenberg, <daniel@haxx.se>, et al. -.\" * -.\" * This software is licensed as described in the file COPYING, which -.\" * you should have received as part of this distribution. The terms -.\" * are also available at http://curl.haxx.se/docs/copyright.html. -.\" * -.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell -.\" * copies of the Software, and permit persons to whom the Software is -.\" * furnished to do so, under the terms of the COPYING file. -.\" * -.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY -.\" * KIND, either express or implied. -.\" * -.\" * $Id$ -.\" ************************************************************************** -.\" -.TH runtests.pl 1 "11 Oct 2007" "Curl 7.17.1" "runtests" -.SH NAME -runtests.pl \- run one or more test cases -.SH SYNOPSIS -.B runtests.pl [options] [test number] [!test number] [key word] [!key word] -.SH DESCRIPTION -\fIruntests.pl\fP runs one, several or all the existing test cases in curl's -test suite. It is often called from the root Makefile of the curl package with -\&'make test'. -.SH "TEST NUMBER" -If no test case number is given, all existing tests that the script can find -will be considered for running. You can specify single test cases to run, -space-separated, like "1 3 5 7 11", and you can specify a range like "45 to -67". You can also specify only the tests you don't want to run by listing -the numbers with a leading exclamation point, like "!66". -.P -It is also possible to specify tests to skip based on a key word describing -the test. These are specified with a leading exclamation point and the -key word or phrase, like "!HTTP NTLM auth". Likewise, tests to run can -be specified simply by specifying the unadorned key words, like "FTPS". -Remember that the exclamation marks and spaces will need to be quoted somehow -when entered at many command shells. -.SH OPTIONS -.IP "-a" -Continue running the rest of the test cases even if one test fails. By -default, the test script stops as soon as an error is detected. -.IP "-bN" -Use N as the base TCP/UDP port number on which to start the test servers. -.IP "-c <curl>" -Provide 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 "-g" -Run the given test(s) with gdb. This is best used on a single test case and -curl built --disable-shared. This then fires up gdb with command line set to -run the specified test case. Simply (set a break-point and) type 'run' to -start. -.IP "-h" -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" -Lists all test case names. -.IP "-n" -Disable the check for and use of valgrind. -.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 -people checking the failures and the reasons for them might not have physical -access to the machine and logs. -.IP "-s" -Shorter output. Speaks less than default. -.IP "-t[num]" -Selects a \fBtorture\fP test for the given tests. This makes runtests.pl first -run the tests once and count the number of memory allocations made. It then -reruns the test that number of times, each time forcing one of the allocations -to fail until all allocs have been tested. By setting \fInum\fP you can force -the allocation with that number to be set to fail at once instead of looping -through everyone, which is very handy when debugging and then often in -combination with \fI-g\fP. -.IP "-v" -Enable verbose output. Speaks more than default. -.SH "RUNNING TESTS" -Many tests have conditions that must be met before the test case can run -fine. They could depend on built-in features in libcurl or features present in -the operating system or even in third-party libraries that curl may or may not -use. -.P -The test script checks most of these by itself to determine when it is -safe to attempt to run each test. Those which cannot be run due to -failed requirements will simply be skipped and listed at the completion -of all test cases. In some unusual configurations, the test script -cannot make the correct determination for all tests. In these cases, -the problematic tests can be skipped using the "!keyword" skip feature -documented earlier. -.SH "WRITING TESTS" -The simplest way to write test cases is to start with a similar existing test, -save it with a new number and then adjust it to fit. There's an attempt to -document the test case file format in the tests/FILEFORMAT. |