File
tests/README.txt
— part of check-in
[05b2dd47be]
at
2023-05-24 01:18:52
on branch status_x509
— Updated ciphers command to use current APIs and added an option to return only ciphers as would be sent in ClientHello.
Updated test suite to use OpenSSL executable to get ciphers comparison data.
Added more test cases.
Addresses defects:
https://core.tcl-lang.org/tcltls/tktview/688788a45c
and
https://sourceforge.net/p/tls/bugs/36/
(user:
bohagan,
size: 775)
[annotate]
[blame][check-ins using][more...]
0000: 43 72 65 61 74 65 20 54 65 73 74 20 43 61 73 65 Create Test Case
0010: 73 0a 0a 31 2e 20 43 72 65 61 74 65 20 74 65 73 s..1. Create tes
0020: 74 20 63 61 73 65 20 2a 2e 63 73 76 20 66 69 6c t case *.csv fil
0030: 65 2e 20 59 6f 75 20 63 61 6e 20 75 73 65 20 6d e. You can use m
0040: 75 6c 74 69 70 6c 65 20 66 69 6c 65 73 2e 20 47 ultiple files. G
0050: 65 6e 65 72 61 6c 6c 79 20 69 74 27 73 20 61 20 enerally it's a
0060: 67 6f 6f 64 20 69 64 65 61 20 74 6f 20 67 72 6f good idea to gro
0070: 75 70 20 6c 69 6b 65 20 66 75 6e 63 74 69 6f 6e up like function
0080: 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 66 69 s in the same fi
0090: 6c 65 2e 0a 0a 32 2e 20 41 64 64 20 74 65 73 74 le...2. Add test
00a0: 20 63 61 73 65 73 20 74 6f 20 2a 2e 63 73 76 20 cases to *.csv
00b0: 66 69 6c 65 73 2e 0a 09 45 61 63 68 20 74 65 73 files...Each tes
00c0: 74 20 63 61 73 65 20 69 73 20 6f 6e 20 61 20 73 t case is on a s
00d0: 65 70 61 72 61 74 65 20 6c 69 6e 65 2e 20 45 61 eparate line. Ea
00e0: 63 68 20 63 6f 6c 75 6d 6e 20 64 65 66 69 6e 65 ch column define
00f0: 73 20 74 68 65 20 65 71 75 69 76 61 6c 65 6e 74 s the equivalent
0100: 20 69 6e 70 75 74 20 74 68 65 20 74 63 6c 74 65 input the tclte
0110: 73 74 20 74 6f 6f 6c 20 65 78 70 65 63 74 73 2e st tool expects.
0120: 0a 0a 33 2e 20 44 65 66 69 6e 65 20 61 6e 79 20 ..3. Define any
0130: 63 6f 6d 6d 6f 6e 20 66 75 6e 63 74 69 6f 6e 73 common functions
0140: 20 69 6e 20 63 6f 6d 6d 6f 6e 2e 74 63 6c 20 6f in common.tcl o
0150: 72 20 69 6e 20 2a 2e 63 73 76 20 66 69 6c 65 2e r in *.csv file.
0160: 0a 0a 34 2e 20 54 6f 20 63 72 65 61 74 65 20 74 ..4. To create t
0170: 68 65 20 74 65 73 74 20 63 61 73 65 73 20 73 63 he test cases sc
0180: 72 69 70 74 2c 20 65 78 65 63 75 74 65 20 6d 61 ript, execute ma
0190: 6b 65 5f 74 65 73 74 5f 66 69 6c 65 73 2e 74 63 ke_test_files.tc
01a0: 6c 2e 20 54 68 69 73 20 77 69 6c 6c 20 75 73 65 l. This will use
01b0: 20 74 68 65 20 2a 2e 63 73 76 20 66 69 6c 65 73 the *.csv files
01c0: 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 2a to create the *
01d0: 2e 74 65 73 74 20 66 69 6c 65 73 2e 0a 0a 45 78 .test files...Ex
01e0: 65 63 75 74 65 20 54 65 73 74 20 53 75 69 74 65 ecute Test Suite
01f0: 0a 0a 35 2e 20 54 6f 20 72 75 6e 20 74 68 65 20 ..5. To run the
0200: 74 65 73 74 20 73 75 69 74 65 2c 20 65 78 65 63 test suite, exec
0210: 75 74 65 20 74 68 65 20 61 6c 6c 2e 74 63 6c 20 ute the all.tcl
0220: 66 69 6c 65 2e 20 54 68 65 20 72 65 73 75 6c 74 file. The result
0230: 73 20 77 69 6c 6c 20 62 65 20 6f 75 74 70 75 74 s will be output
0240: 20 74 6f 20 74 68 65 20 73 74 64 6f 75 74 6c 6f to the stdoutlo
0250: 67 2e 74 78 74 20 66 69 6c 65 2e 0a 09 4f 6e 20 g.txt file...On
0260: 57 69 6e 64 6f 77 73 20 79 6f 75 20 63 61 6e 20 Windows you can
0270: 61 6c 73 6f 20 75 73 65 20 74 68 65 20 72 75 6e also use the run
0280: 5f 61 6c 6c 5f 74 65 73 74 73 2e 62 61 74 20 66 _all_tests.bat f
0290: 69 6c 65 2e 0a 0a 36 2e 20 52 65 76 69 65 77 20 ile...6. Review
02a0: 73 74 64 6f 75 74 6c 6f 67 2e 74 78 74 20 66 6f stdoutlog.txt fo
02b0: 72 20 74 68 65 20 63 6f 75 6e 74 20 6f 66 20 74 r the count of t
02c0: 65 73 74 20 63 61 73 65 73 20 65 78 65 63 75 74 est cases execut
02d0: 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 ed successfully
02e0: 61 6e 64 20 76 69 65 77 20 64 65 74 61 69 6c 73 and view details
02f0: 20 6f 66 20 74 68 6f 73 65 20 74 68 61 74 20 66 of those that f
0300: 61 69 6c 65 64 2e 0a ailed..