In this section:

Introduction

The asmcovbuf tool to merges the dynamic data file (.padd) generated by executing an instrumented executable with its corresponding static data file (.pail). The static data is generated by the Asminst during compilation and linking. Refer to Parasoft ASMTools for information about the full tool chain, including installation and requirements.

In this section, we assume that you've already installed Parasoft ASMTools and that they are on your system path. 

Basic Usage

Run asmcovbuf and specify the static and dynamic data files to merge the correct data from the dynamic data file into the static data file:

$ asmcovbuf --static-data /path/to/static-data-file.pail --dynamic-data /path/to/dynamic-data-file.padd

Use the --static-data flag ( or -i) to specify the static data file. This file is created by instrumenting  objects, archives, and executables using the Asminst. 

Use the --dynamic-data flag (or -d) to specify the dynamic data file. This file is extracted from the instrumented executable by running the executable with the Asminst.

Both files are required. The dynamic data will be merged into the static data file as a result of running asmcovbuf.

Examples

$ asmcovbuf --static-data C:\path\to\static\data\example.pail --dynamic-data C:\path\to\dynamic\data\example.padd

$ asmcovbuf --static-data /path/to/static/data/example.pail --dynamic-data /path/to/dynamic/data/example.padd

Merging Multiple Files

You can specify multiple static and dynamic files in a single command, which enables you to merge coverage for multiple runs. In the following examples, the dynamic data from example.padd will be merged into the example.pail and example2.pail files, providing coverage for different runs:

$ asmcovbuf -i C:\path\to\static\data\example.pail -d C:\path\to\dynamic\data\example.padd 

$ asmcovbuf -i /path/to/static/data/example.pail -d /path/to/dynamic/data/example.padd 

Asmcovbuf will only merge data when it finds correlations between the static and dynamic data. Additionally, the order of the files does not matter. As a result, you can run asmcovbuf with any files in the workspace and in any order, and the tool will correctly merge coverage. 

Options