[or-cvs] r16254: Docment gcov in HACKING (in tor/trunk: . doc)

[nickm@xxxxxxxx]

Author: nickm
Date: 2008-07-30 09:04:19 -0400 (Wed, 30 Jul 2008)
New Revision: 16254

Modified:
   tor/trunk/
   tor/trunk/doc/HACKING
Log:
 r17433@tombo:  nickm | 2008-07-29 10:58:07 -0400
 Docment gcov in HACKING



Property changes on: tor/trunk
___________________________________________________________________
 svk:merge ticket from /tor/trunk [r17433] on 49666b30-7950-49c5-bedf-9dc8f3168102

Modified: tor/trunk/doc/HACKING
===================================================================
--- tor/trunk/doc/HACKING	2008-07-30 11:21:25 UTC (rev 16253)
+++ tor/trunk/doc/HACKING	2008-07-30 13:04:19 UTC (rev 16254)
@@ -2,7 +2,7 @@
 0. The buildbot.
 
   http://tor-buildbot.freehaven.net:8010/
-  
+
   - Down for unknown reasons, ioerror will look into this.
 
 0.1. Useful command-lines that are non-trivial to reproduce but can
@@ -14,6 +14,19 @@
 
 valgrind --leak-check=yes --error-limit=no --show-reachable=yes src/or/tor
 
+0.2. Running gcov for unit test coverage
+
+  make clean
+  make CFLAGS='-g -fprofile-arcs -ftest-coverage'
+  ./src/or/test
+  cd src/common; gcov *.[ch]
+  cd ../or; gcov *.[ch]
+
+  Then, look at the .gcov files.  '-' before a line means that the
+  compiler generated  no code for that line.  '######' means that the
+  line was never reached.  Lines with numbers were called that number
+  of times.
+
 1. Coding conventions
 
 1.0. Whitespace and C conformance