aboutsummaryrefslogtreecommitdiff
path: root/tests/README
blob: 35f7966b0b214dd6d055da6a47c26ac3664cf9c1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
                                  _   _ ____  _     
                              ___| | | |  _ \| |    
                             / __| | | | |_) | |    
                            | (__| |_| |  _ <| |___ 
                             \___|\___/|_| \_\_____|

The cURL Test Suite

Requires:
  perl

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 -s fort shorter output, or pass a string with test numbers to run
  specific tests only (like ./runtests.pl "3 4" to test 3 and 4 only)

Logs:
  All logs are generated in the logs/ subdirctory (it is emtpied first
  in the runtests.sh script)

Data:
  All test-data are put in the data/ subdirctory.

  For each tests there exist four files. Replace N with the test number:

    nameN.txt: test description as displayed when run

    commandN.txt: command line options for this test

    httpN.txt: the full dump of the HTTP protocol communication that curl is
               expected to use when performing this test

    replyN.txt: the full dump the server should reply to curl for this test.
               If the final result that curl should've got is not in this
               file, you can instead name the file replyN0001.txt. This enables
               you to fiddle more. ;-)

    stdoutN.txt: if this file is present, curl's stdout is compared against
               this file to see that they're identical. If this is present,
               curl will not be run with -o but instead all output is compared
               against this file!

FIX:

  * Make httpserver.pl work when we PUT without Content-Length: