Index: third_party/lcov-1.9/README |
diff --git a/third_party/lcov-1.9/README b/third_party/lcov-1.9/README |
deleted file mode 100644 |
index 654216295caef417b20c7fde6b17203f1d99be45..0000000000000000000000000000000000000000 |
--- a/third_party/lcov-1.9/README |
+++ /dev/null |
@@ -1,137 +0,0 @@ |
-------------------------------------------------- |
-- README file for the LTP GCOV extension (LCOV) - |
-- Last changes: 2010-08-06 - |
-------------------------------------------------- |
- |
-Description |
------------ |
- LCOV is an extension of GCOV, a GNU tool which provides information about |
- what parts of a program are actually executed (i.e. "covered") while running |
- a particular test case. The extension consists of a set of PERL scripts |
- which build on the textual GCOV output to implement the following enhanced |
- functionality: |
- |
- * HTML based output: coverage rates are additionally indicated using bar |
- graphs and specific colors. |
- |
- * Support for large projects: overview pages allow quick browsing of |
- coverage data by providing three levels of detail: directory view, |
- file view and source code view. |
- |
- LCOV was initially designed to support Linux kernel coverage measurements, |
- but works as well for coverage measurements on standard user space |
- applications. |
- |
- |
-Further README contents |
------------------------ |
- 1. Included files |
- 2. Installing LCOV |
- 3. An example of how to access kernel coverage data |
- 4. An example of how to access coverage data for a user space program |
- 5. Questions and Comments |
- |
- |
- |
-1. Important files |
------------------- |
- README - This README file |
- CHANGES - List of changes between releases |
- bin/lcov - Tool for capturing LCOV coverage data |
- bin/genhtml - Tool for creating HTML output from LCOV data |
- bin/gendesc - Tool for creating description files as used by genhtml |
- bin/geninfo - Internal tool (creates LCOV data files) |
- bin/genpng - Internal tool (creates png overviews of source files) |
- bin/install.sh - Internal tool (takes care of un-/installing) |
- descriptions.tests - Test descriptions for the LTP suite, use with gendesc |
- man - Directory containing man pages for included tools |
- example - Directory containing an example to demonstrate LCOV |
- lcovrc - LCOV configuration file |
- Makefile - Makefile providing 'install' and 'uninstall' targets |
- |
- |
-2. Installing LCOV |
------------------- |
-The LCOV package is available as either RPM or tarball from: |
- |
- http://ltp.sourceforge.net/coverage/lcov.php |
- |
-To install the tarball, unpack it to a directory and run: |
- |
- make install |
- |
-Use anonymous CVS for the most recent (but possibly unstable) version: |
- |
- cvs -d:pserver:anonymous@ltp.cvs.sourceforge.net:/cvsroot/ltp login |
- |
-(simply press the ENTER key when asked for a password) |
- |
- cvs -z3 -d:pserver:anonymous@ltp.cvs.sourceforge.net:/cvsroot/ltp export -D now utils |
- |
-Change to the utils/analysis/lcov directory and type: |
- |
- make install |
- |
- |
-3. An example of how to access kernel coverage data |
---------------------------------------------------- |
-Requirements: get and install the gcov-kernel package from |
- |
- http://sourceforge.net/projects/ltp |
- |
-Copy the resulting gcov kernel module file to either the system wide modules |
-directory or the same directory as the PERL scripts. As root, do the following: |
- |
- a) Resetting counters |
- |
- lcov --zerocounters |
- |
- b) Capturing the current coverage state to a file |
- |
- lcov --capture --output-file kernel.info |
- |
- c) Getting HTML output |
- |
- genhtml kernel.info |
- |
-Point the web browser of your choice to the resulting index.html file. |
- |
- |
-4. An example of how to access coverage data for a user space program |
---------------------------------------------------------------------- |
-Requirements: compile the program in question using GCC with the options |
--fprofile-arcs and -ftest-coverage. During linking, make sure to specify |
--lgcov or -coverage. |
- |
-Assuming the compile directory is called "appdir", do the following: |
- |
- a) Resetting counters |
- |
- lcov --directory appdir --zerocounters |
- |
- b) Capturing the current coverage state to a file (works only after the |
- application has been started and stopped at least once) |
- |
- lcov --directory appdir --capture --output-file app.info |
- |
- c) Getting HTML output |
- |
- genhtml app.info |
- |
-Point the web browser of your choice to the resulting index.html file. |
- |
-Please note that independently of where the application is installed or |
-from which directory it is run, the --directory statement needs to |
-point to the directory in which the application was compiled. |
- |
-For further information on the gcc profiling mechanism, please also |
-consult the gcov man page. |
- |
- |
-5. Questions and comments |
-------------------------- |
-See the included man pages for more information on how to use the LCOV tools. |
- |
-Please email further questions or comments regarding this tool to the |
-LTP Mailing list at ltp-coverage@lists.sourceforge.net |
- |