= Improve Coverage Analysis Toolset =


[[TOC(PAGE_LOCATION, depth=2)]]


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

[[span(style=color: #FF0000, 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