| 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
|
| -
|
|
|