Home | History | Annotate | only in /external/chromium_org/third_party/lcov
Up to higher level directory
NameDateSize
bin/06-Dec-2013
CHANGES06-Dec-201310.7K
contrib/06-Dec-2013
descriptions.tests06-Dec-201368.6K
example/06-Dec-2013
lcovrc06-Dec-20133.5K
LICENSE06-Dec-2013843
Makefile06-Dec-20133.6K
man/06-Dec-2013
README06-Dec-20134.2K
README.chromium06-Dec-2013417
rpm/06-Dec-2013

README

      1 -------------------------------------------------
      2 - README file for the LTP GCOV extension (LCOV) -
      3 - Last changes: 2008-11-17                      -
      4 -------------------------------------------------
      5 
      6 Description
      7 -----------
      8   LCOV is an extension of GCOV, a GNU tool which provides information about
      9   what parts of a program are actually executed (i.e. "covered") while running
     10   a particular test case. The extension consists of a set of PERL scripts
     11   which build on the textual GCOV output to implement the following enhanced
     12   functionality:
     13 
     14     * HTML based output: coverage rates are additionally indicated using bar
     15       graphs and specific colors.
     16 
     17     * Support for large projects: overview pages allow quick browsing of
     18       coverage data by providing three levels of detail: directory view,
     19       file view and source code view.
     20 
     21   LCOV was initially designed to support Linux kernel coverage measurements,
     22   but works as well for coverage measurements on standard user space
     23   applications.
     24 
     25 
     26 Further README contents
     27 -----------------------
     28   1. Included files
     29   2. Installing LCOV
     30   3. An example of how to access kernel coverage data
     31   4. An example of how to access coverage data for a user space program
     32   5. Questions and Comments
     33 
     34 
     35 
     36 1. Important files
     37 ------------------
     38   README             - This README file
     39   CHANGES            - List of changes between releases
     40   bin/lcov           - Tool for capturing LCOV coverage data
     41   bin/genhtml        - Tool for creating HTML output from LCOV data
     42   bin/gendesc        - Tool for creating description files as used by genhtml
     43   bin/geninfo        - Internal tool (creates LCOV data files)
     44   bin/genpng         - Internal tool (creates png overviews of source files)
     45   bin/install.sh     - Internal tool (takes care of un-/installing)
     46   descriptions.tests - Test descriptions for the LTP suite, use with gendesc
     47   man                - Directory containing man pages for included tools
     48   example            - Directory containing an example to demonstrate LCOV
     49   lcovrc             - LCOV configuration file
     50   Makefile           - Makefile providing 'install' and 'uninstall' targets
     51 
     52 
     53 2. Installing LCOV
     54 ------------------
     55 The LCOV package is available as either RPM or tarball from:
     56      
     57   http://ltp.sourceforge.net/coverage/lcov.php
     58 
     59 To install the tarball, unpack it to a directory and run:
     60 
     61   make install
     62 
     63 Use anonymous CVS for the most recent (but possibly unstable) version:
     64 
     65   cvs -d:pserver:anonymous (a] ltp.cvs.sourceforge.net:/cvsroot/ltp login
     66 
     67 (simply press the ENTER key when asked for a password)
     68 
     69   cvs -z3 -d:pserver:anonymous (a] ltp.cvs.sourceforge.net:/cvsroot/ltp export -D now utils
     70 
     71 Change to the utils/analysis/lcov directory and type:
     72 
     73   make install
     74 
     75 
     76 3. An example of how to access kernel coverage data
     77 ---------------------------------------------------
     78 Requirements: get and install the gcov-kernel package from
     79 
     80   http://sourceforge.net/projects/ltp
     81 
     82 Copy the resulting gcov kernel module file to either the system wide modules
     83 directory or the same directory as the PERL scripts. As root, do the following:
     84 
     85   a) Resetting counters
     86 
     87      lcov --zerocounters
     88 
     89   b) Capturing the current coverage state to a file
     90 
     91      lcov --capture --output-file kernel.info
     92 
     93   c) Getting HTML output
     94 
     95      genhtml kernel.info
     96 
     97 Point the web browser of your choice to the resulting index.html file.
     98 
     99 
    100 4. An example of how to access coverage data for a user space program
    101 ---------------------------------------------------------------------
    102 Requirements: compile the program in question using GCC with the options
    103 -fprofile-arcs and -ftest-coverage. Assuming the compile directory is called
    104 "appdir", do the following:
    105 
    106   a) Resetting counters
    107 
    108      lcov --directory appdir --zerocounters
    109 
    110   b) Capturing the current coverage state to a file (works only after the
    111      application has been started and stopped at least once)
    112 
    113      lcov --directory appdir --capture --output-file app.info
    114 
    115   c) Getting HTML output
    116 
    117      genhtml app.info
    118 
    119 Point the web browser of your choice to the resulting index.html file.
    120 
    121 
    122 5. Questions and comments
    123 -------------------------
    124 See the included man pages for more information on how to use the LCOV tools.
    125 
    126 Please email further questions or comments regarding this tool to the
    127 LTP Mailing list at ltp-coverage (a] lists.sourceforge.net  
    128 
    129

README.chromium

      1 Name: LCOV - the LTP GCOV extension
      2 Short Name: lcov
      3 URL: http://ltp.sourceforge.net/coverage/lcov.php
      4 Version: 1.7
      5 License: GPL v2
      6 Security Critical: no
      7 
      8 Description:
      9 This directory contains a stock lcov-1.7 with the following changes:
     10 
     11 - Added bin/mcov, an assembly script derived from lcov which is
     12  particularly useful for dealing with Mac XCode build paths.
     13 - Added LICENSE file pulled from the top of bin/lcov.
     14