]> granicus.if.org Git - curl/commitdiff
Added a code coverage section using gcc and gcov.
authorDan Fandrich <dan@coneharvesters.com>
Tue, 10 Jul 2007 22:55:51 +0000 (22:55 +0000)
committerDan Fandrich <dan@coneharvesters.com>
Tue, 10 Jul 2007 22:55:51 +0000 (22:55 +0000)
tests/README

index aa442f755b5e8c6123971c90f5b11ec1c3b4e596..c2fea8db1ec0fdc509afeb9837ddd088e4736195 100644 (file)
@@ -84,6 +84,24 @@ Data:
 
   See FILEFORMAT for the description of the test case files.
 
+Code coverage:
+  gcc provides a tool that can determine the code coverage figures for
+  the test suite.  To use it, configure curl with
+  CFLAGS='-fprofile-arcs -ftest-coverage -g -O0'.  Make sure you run the normal
+  and torture tests to get more full coverage, i.e. do:
+
+    make test
+    cd tests
+    make torture-test
+
+  The graphical tool ggcov can be used to browse the source and create
+  coverage reports on *NIX hosts:
+
+    ggcov -r lib src
+
+  The text mode tool gcov may also be used, but it doesn't handle object files
+  in more than one directory very well.
+
 
 TEST CASE NUMBERS
 
@@ -97,7 +115,7 @@ TEST CASE NUMBERS
  500 - 599   libcurl source code tests, not using the curl command tool
  600 - 699   SCP/SFTP
  700 - 799   SOCKS4 (even numbers) and SOCK5 (odd numbers)
- 1000 - x    miscellanous*
+ 1000 - x    miscellaneous*
 
  Since 30-apr-2003, there's nothing in the system that requires us to keep
  within these number series, and those sections marked with * actually