wiki:GSoC/2018/coverage_analysis_toolset

Version 2 (modified by Vijay Kumar Banerjee, on 05/23/18 at 12:59:54) (diff)

--

Improve Coverage Analysis Toolset

Table of Contents

    Error: Page PAGE_LOCATION does not exist

Mentors: Chris Johns, Joel Sherrill, C.P. O'Donnell

Students: Vijay Kumar Banerjee

Progress: The Coverage Analysis is running and generating coverage reports in html and txt format

Blockers: Generating .gcno notes files by changing gcc flags

Introduction

This project is to improve the tools used to perform the analysis and generate reports. It will convert all the config files to .ini and get the coverage analysis running properly. Then the coverage tools will be integrated with RTEMS Tester . Also gcov reports will be generated and the report generation of the covoar tool will be reworked to give output it some data-centric format.

Project

prerequisites

  • Covoar and rtemstoolkit (C++)
  • RTEMS Tester framework (Python)
  • Understand INI format for config files.
  • Reports (HTML and text currently, add XML)

Running covoar for coverage analysis

To run covoar we need to run covoar from the RTEMS-KERNEL BUILD directory.

NOTE : The .cov trace files are needed to get coverage reports

covoar -S /home/lunatic/development/rtems/test/rtems-tools/tester/rtems/testing/coverage/score-symbols.ini \
-O /home/lunatic/coverage_test/test/score \
-E/home/lunatic/development/rtems/test/rtems-tools/tester/rtems/testing/coverage/Explanations.txt \
-p RTEMS-5 -v sparc-rtems5/c/leon3/testsuites/samples/hello/hello.exe

covoar usage :

Usage: covoar [-v] -T TARGET -f FORMAT [-E EXPLANATIONS] -e EXE_EXTENSION -c COVERAGEFILE_EXTENSION EXECUTABLE1 ... EXECUTABLE2

  -v                        - verbose at initialization
  -T TARGET                 - target name
  -f FORMAT                 - coverage file format (RTEMS, QEMU, TSIM or Skyeye)
  -E EXPLANATIONS           - name of file with explanations
  -s SYMBOL_SET_FILE        - path to the INI format symbol sets
  -1 EXECUTABLE             - name of executable to get symbols from
  -e EXE_EXTENSION          - extension of the executables to analyze
  -c COVERAGEFILE_EXTENSION - extension of the coverage files to analyze
  -g GCNOS_LIST             - name of file with list of *.gcno files
  -p PROJECT_NAME           - name of the project
  -C ConfigurationFileName  - name of configuration file
  -O Output_Directory       - name of output directory (default=.
  -d debug                  - disable cleaning of tempfile

Resources

TBA

References

  • TBD