<code_coverage>.filter-mappings <code_coverage>.info
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<code_coverage>.html-report

Synopsis

<code_coverage>.html-report output ["report-name"] [-no-disassembly] [-no-unmapped-addresses] [-no-unknown-modules] [-no-summary-table] [-no-module-line-coverage] [-only-addresses-with-source] [-only-disassembly] [-include-opcode] [-include-line] [-no-data-labels] [max-errors-per-mapping] [-summary-per-file] [-tree-summary] [-show-line-functions] [-source-only-data] ["source-files-base-path"]

Description

Create an HTML code coverage report, with the root directory specified by the output argument.

The report-name argument can be used to give the report a name, this will be displayed as the title and header in the HTML pages.

If the -no-disassembly flag is set, no disassembly will be included in the HTML report.

If the -no-unmapped-addresses flag is set, addresses that has been run, but was not mapped into a known memory map of any symbol file will be ignored. This can typically be addresses that are part of interrupt routines, padding instructions between functions, or addresses for which there where no mapping found, although there should have been.

If the -no-unknown-modules flag is set, modules that has no debug information mapping of any kind associated with them, will not show up in the report.

If the -no-summary-table flag is set, the function coverage summary for the disassembly report will be disabled.

If the -no-module-line-coverage flag is set, source line coverage per symbol file and function will be excluded from disassembly reports.

If the -only-addresses-with-source flag is set, instructions that are not associated with any source line will be excluded from the disassembly report.

If the -only-disassembly flag is set, no source code coverage will be reported, only the disassembly coverage.

If the -include-opcode flag is set opcode will be shown in the disassembly coverage report.

If the -include-line flag is set line numbers will be shown in the disassembly coverage report.

The -summary-per-file flag specifies that the source coverage page should include every file on that page, otherwise the main page will group coverage per directory.

The -tree-summary flag specifies that the summary page should be presented in such a way that covered lines and percentage include coverage for all sub-directories as well.

The -show-line-functions flag can be used to output which functions make use of each line, in the source file reports. This can be useful to gain a better understanding of why source lines are covered or not when there are optimizations and inlined code involved.

The -no-data-labels flag will tell the command to not try to handle certain function names as data labels and instead keep them as functions. This will lead to that these labels as included in the disassembly report as functions, even though they are most likely data. Without this options data ranges following such labels will be excluded from the report. Altering this flag implies removing old data.

The -source-only-data flag will force the source code data to be collected in the way the add-source-only-info command does it, regardless of architecture. This implies the -no-disassembly flag. Previously added source and disassembly information of other format will be removed from the raw report data.

The source-files-base-path option can be used to override the default base path on the source files summary page. Setting this to "" will result in full paths being displayed for all paths.

The max-errors-per-mapping argument can be used to specify a maximum number of errors to show per mapping. If this is set to a negative value an unlimited amout of errors will be shown.

If the data collection done by the add-functions, and disassemble, add-source-info commands has not been performed, this will be done before saving the report.

Provided By

code-coverage
<code_coverage>.filter-mappings <code_coverage>.info