curl/tests
Dan Fandrich 66fc5498d2 Added test cases 296, 297 and 298 to test --ftp-method handling 2007-04-18 06:30:28 +00:00
..
data Added test cases 296, 297 and 298 to test --ftp-method handling 2007-04-18 06:30:28 +00:00
libtest unify fopen() failure error message among tests, allowing 2007-04-05 11:05:36 +00:00
server update copyright year 2007-04-03 18:25:18 +00:00
.cvsignore ignore more generated files 2007-03-30 02:59:39 +00:00
FILEFORMAT Changed the test harness to attempt to gracefully shut down servers 2007-03-24 01:01:28 +00:00
Makefile.am Added sshserver.pl 2007-03-24 06:29:58 +00:00
README Tighten up a few more OpenSSH options 2007-03-27 04:01:39 +00:00
ftp.pm Revert ftp.pm back to revision 1.5 Adding copyright notice. 2006-11-20 16:57:01 +00:00
ftpserver.pl Reduce the posibility of leaving the sockfilter hanging around when 2007-03-01 16:42:02 +00:00
getpart.pm Make the test script tag parser a bit more robust. 2007-01-18 20:32:46 +00:00
httpserver.pl support --fork and pass that on to sws 2006-04-10 13:09:56 +00:00
httpsserver.pl Added test infrastructure to support basic FTPS tests. This currently 2007-03-08 02:38:49 +00:00
keywords.pl sum up 2005-05-20 11:14:44 +00:00
memanalyze.pl Support realloc() on a NULL pointer properly (printf(%p) on a NULL pointer 2005-08-04 23:05:36 +00:00
runtests.1 format mistake 2005-03-21 07:45:18 +00:00
runtests.pl Honour the -a option when -t is enabled. 2007-04-10 00:37:56 +00:00
sshserver.pl when detecting un/supported sshd options use curl's sshd config file. 2007-04-03 02:36:55 +00:00
stunnel.pem jayjwa added the "DH PARAMETERS" to make this work with recent stunnels 2007-04-14 20:29:09 +00:00
testcurl.1 added -nobuildconf 2005-05-20 11:24:55 +00:00
testcurl.pl print update message only if we really update CVS. 2007-04-01 13:59:50 +00:00
valgrind.pm Moved out the valgrind report parser to valgrind.pm, to make it easier to 2005-02-10 08:50:33 +00:00

README

                                  _   _ ____  _     
                              ___| | | |  _ \| |    
                             / __| | | | |_) | |    
                            | (__| |_| |  _ <| |___ 
                             \___|\___/|_| \_\_____|

The cURL Test Suite

Requires:
  perl (and a unix-style shell)
  diff (when a test fail, a diff is shown)
  stunnel (for HTTPS and FTPS tests)
  sshd (for SCP and SFTP tests; OpenSSH ver. 3.8 is known to work)

TCP ports used:

  - 8990 on localhost for HTTP tests
  - 8991 on localhost for HTTPS tests
  - 8994 on localhost for HTTP IPv6 tests
  - 8992 on localhost for FTP tests
  - 8995 on localhost for FTP (2) tests
  - 8993 on localhost for FTPS tests
  - 8996 on localhost for FTP IPv6 tests
  - 8997 on localhost for TFTP tests
  - 8999 on localhost for SCP/SFTP tests

  The test suite runs simple FTP, HTTP and TFTP servers on these ports to
  which it makes requests.  For SSL tests, it runs stunnel to handle
  encryption to the regular servers. For SSH, it runs a standard OpenSSH
  server.

Run:
  'make test'. This invokes the 'runtests.pl' perl script. Edit the top
  variables of that script in case you have some specific needs.

  The script breaks on the first test that doesn't do OK. Use -a to prevent
  the script to abort on the first error. Run the script with -v for more
  verbose output. Use -d to run the test servers with debug output enabled as
  well.

  Use -s for shorter output, or pass test numbers to run specific tests only
  (like "./runtests.pl 3 4" to test 3 and 4 only). It also supports test case
  ranges with 'to'. As in "./runtests 3 to 9" which runs the seven tests from
  3 to 9.

Memory:
  The test script will check that all allocated memory is freed properly IF
  curl has been built with the CURLDEBUG define set. The script will
  automatically detect if that is the case, and it will use the ../memanalyze
  script to analyze the memory debugging output.

Debug:
  If a test case fails, you can conveniently get the script to invoke the
  debugger (gdb) for you with the server running and the exact same command
  line parameters that failed. Just invoke 'runtests.pl <test number> -g' and
  then just type 'run' in the debugger to perform the command through the
  debugger.

  If a test case causes a core dump, analyze it by running gdb like:

          # gdb ../curl/src core

  ... and get a stack trace with the gdb command:

          (gdb) where

Logs:
  All logs are generated in the logs/ subdirectory (it is emptied first
  in the runtests.pl script). Use runtests.pl -k to keep the temporary files
  after the test run.

Data:
  All test cases are put in the data/ subdirectory. Each test is stored in the
  file named according to the test number.

  See FILEFORMAT for the description of the test case files.


TEST CASE NUMBERS

 So far, I've used this system:

 1   -  99   HTTP
 100 - 199   FTP
 200 - 299   FILE
 300 - 399   HTTPS
 400 - 499   FTPS
 500 - 599   libcurl source code tests, not using the curl command tool
 600 - 699   SCP/SFTP

 Since 30-apr-2003, there's nothing in the system that requires us to keep
 within these number series. Each test case now specifies its own server
 requirements, independent of test number.

TODO:

  * Add tests for TELNET, LDAP, DICT...