~ubuntu-branches/ubuntu/gutsy/curl/gutsy-updates

« back to all changes in this revision

Viewing changes to tests/README

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2007-08-01 12:22:30 UTC
  • mfrom: (1.1.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20070801122230-uaarmp6lo65py9t6
Tags: 7.16.4-1ubuntu1
* Merge with Debian.
  - Drop debian/patches/gnutls-verifications, applied upstream.
  - Remove all stuff which should be reverted according to 7.16.2-6ubuntu4.
  - Remaining change: drop stunnel build dependency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
11
11
  diff (when a test fail, a diff is shown)
12
12
  stunnel (for HTTPS and FTPS tests)
13
13
  sshd (for SCP and SFTP tests; OpenSSH ver. 3.8 is known to work)
 
14
  ssh (for SOCKS4 and SOCK5 tests; OpenSSH ver. 4.5 is known to work.
 
15
       OpenSSH version 3.7 or greater is needed for SOCKS5)
14
16
 
15
 
TCP ports used:
 
17
TCP ports used by default:
16
18
 
17
19
  - 8990 on localhost for HTTP tests
18
20
  - 8991 on localhost for HTTPS tests
23
25
  - 8996 on localhost for FTP IPv6 tests
24
26
  - 8997 on localhost for TFTP tests
25
27
  - 8999 on localhost for SCP/SFTP tests
 
28
  - 9000 on localhost for SOCKS tests
26
29
 
27
30
  The test suite runs simple FTP, HTTP and TFTP servers on these ports to
28
31
  which it makes requests.  For SSL tests, it runs stunnel to handle
29
32
  encryption to the regular servers. For SSH, it runs a standard OpenSSH
30
 
  server.
 
33
  server. For SOCKS4/5 tests SSH is used to perform the SOCKS functionality
 
34
  and requires a SSH client and server.
 
35
 
 
36
  The base port number shown above can be changed using runtests' -b option
 
37
  to allow running more than one instance of the test suite simultaneously
 
38
  on one machine.
31
39
 
32
40
Run:
33
41
  'make test'. This invokes the 'runtests.pl' perl script. Edit the top
34
42
  variables of that script in case you have some specific needs.
35
43
 
36
44
  The script breaks on the first test that doesn't do OK. Use -a to prevent
37
 
  the script to abort on the first error. Run the script with -v for more
 
45
  the script from abort on the first error. Run the script with -v for more
38
46
  verbose output. Use -d to run the test servers with debug output enabled as
39
 
  well.
 
47
  well. Specifying -k keeps all the log files generated by the test intact.
40
48
 
41
49
  Use -s for shorter output, or pass test numbers to run specific tests only
42
50
  (like "./runtests.pl 3 4" to test 3 and 4 only). It also supports test case
43
 
  ranges with 'to'. As in "./runtests 3 to 9" which runs the seven tests from
44
 
  3 to 9.
 
51
  ranges with 'to', as in "./runtests 3 to 9" which runs the seven tests from
 
52
  3 to 9. Any test numbers starting with ! are disabled, as are any test
 
53
  numbers found in the file data/DISABLED (one per line).
45
54
 
46
55
Memory:
47
56
  The test script will check that all allocated memory is freed properly IF
81
90
 So far, I've used this system:
82
91
 
83
92
 1   -  99   HTTP
84
 
 100 - 199   FTP
85
 
 200 - 299   FILE
 
93
 100 - 199   FTP*
 
94
 200 - 299   FILE*
86
95
 300 - 399   HTTPS
87
96
 400 - 499   FTPS
88
97
 500 - 599   libcurl source code tests, not using the curl command tool
89
98
 600 - 699   SCP/SFTP
 
99
 700 - 799   SOCKS4 (even numbers) and SOCK5 (odd numbers)
 
100
 1000 - x    miscellanous*
90
101
 
91
102
 Since 30-apr-2003, there's nothing in the system that requires us to keep
92
 
 within these number series. Each test case now specifies its own server
93
 
 requirements, independent of test number.
 
103
 within these number series, and those sections marked with * actually
 
104
 contain tests for a variety of protocols. Each test case now specifies
 
105
 its own server requirements, independent of test number.
94
106
 
95
107
TODO:
96
108
 
97
109
  * Add tests for TELNET, LDAP, DICT...
 
110
  * SOCKS4/5 test deficiencies - no proxy authentication tests as SSH (the 
 
111
    test mechanism) doesn't support them