cmcsexeimport – command line import utility

cmcsexeimport is a utility to import an execution report (.csexe file) into an instrumentation database (.csmes file). It behaves like the menu entry File > Load Execution Report in the CoverageBrowser (see Loading an execution report).

Syntax

cmcsexeimport -m <csmes_file> -t <title> [<options>] <csexe_file>...

Options

• -m <filename> | --csmes=<filename>: Set the name of the .csmes file into which the .csexe files are imported. This parameter is mandatory.
• -t <string> | --title=<string>: Set a default name for the executions in <csexe_file>. This parameter is mandatory.

  Executions that already have a name will be imported unchanged. Others get the name <string>, with a number attached in braces if there is more than one of them.

• <csexe_file>: Name of one of the .csexe files that should be imported.
• <options>:

  Any of:

  • -e <filename> | --csexe=<filename>: Set the name of a .csexe file to be imported. This argument can be repeated to process more than one file.
  • -l <filename> | --csexe-list=<filename>: Read the list of .csexe files to import from a text file. The text file must have one file name per line, without leading or trailing spaces.
  • -p <policy> | --policy=<policy>: Set the import policy. The possible import policies are:
    • ignore_duplicates: Executions are ignored if they have executed the same code as an execution that was already imported. (Default.)
    • import_duplicates: Executions are imported if at least one instrumented source code line is executed.
    • import_duplicates_and_empty: All executions are imported.
    • merge: All executions with the same name are merged. The execution counts of all merged instrumentations are added.
  • -I | --incident: Mark the executions in the imported files as INCIDENT.
  • -S | --skipped: Mark the executions in the imported files as SKIPPED.
  • -P | --passed: Mark the executions in the imported files as PASSED.
  • -F | --failed: Mark the executions in the imported files as FAILED.
  • -C | --check-manually: Mark the executions in the imported files as CHECK_MANUALLY.
  • -f <num> | --csmes-save-frequency=<num>: After every <num> execution reports have been read, the current state of the instrumentation database is written to disk. Without this option, it is written to the disk only at the end.
  • -d | --delete: Delete the imported files after processing them.
  • -v | --verbose: Write progress messages to the standard error output (stderr).
  • -D | --debug: Write debugging information to the standard error output (stderr).
  • @<path>: Read command line options from the file <path> and insert them at the position of this option. The option file is a text file with one option per line. Leading and trailing blanks and empty lines are ignored.