Profmerge and Proforder Tools
Use the profmerge tool to merge dynamic profile information (
.dyn) files and any specified summary files (
.dpi). The compiler executes profmerge automatically during the feedback compilation phase when you specify the
The command-line usage for profmerge is as follows:
profmerge [-prof_dir dir_name]
The tool merges all
.dynfiles in the current directory, or the directory specified by
-prof_dir, and produces a summary file:
The spelling of tools options may differ slightly from compiler options. Tools options use an underscore (for example -prof_dir) instead of the hyphen used by compiler options (for example
[Q]prof-dir) to join words. Also, on Windows* systems, the tool options are preceded by a hyphen ("-") unlike Windows* compiler options, which are preceded by a forward slash ("/").
You can use profmerge tool to merge .dyn files into a
.dpifile without recompiling the application. You can run the instrumented executable file on multiple systems to generate
.dynfiles, and optionally use profmerge with the
-prof_dpioption to name each summary
.dpifile created from the multiple
Because the profmerge tool merges all the
.dynfiles that exist in the given directory, confirm that unrelated
.dynfiles are not present; otherwise, profile information will be based on invalid profile data, which can negatively impact the performance of optimized code.
The profmerge tool supports the following options:
Displays profile information.
Lists supported options.
Disables version information. This option is supported on Windows* only.
Excludes functions from the profile if the function comes from one of the listed files. The list items must be separated by a comma (","); you can use a period (".") as a wild card character in function names.
Excludes functions from the profile. The list items must be separated by a comma (","); you can use a period (".") as a wild card character in function names.
Specifies the name of the
.dpifile being generated.
Merges information from file matching: dpi_file_and_dyn_tag.
Changes the directory path stored within the
Uses only the file name and not the directory name when reading dyn/dpi records. If you specify
-no_src_dir, the directory name of the source file will be ignored when deciding which profile data records correspond to a specific application routine, and the
-src-rootoption is ignored.
Specifies a directory path prefix for the root directory where the user's application files are stored. This option is ignored if you specify
Specifies and merges available
Instructs the tool to display full information during merge.
Instructs the tool to apply an equal weighting (regardless of execution times) to the
.dynfile values to normalize the data counts. This keyword is useful when the execution runs have different time durations and you want them to be treated equally.
Instructs the tool to generate a text file containing a list of the
.dpifile that were merged with default weight=1/run_count.
The text file is created in the directory specified by the
Instructs the profmerge tool to generate and use the text file,
.dpifiles or directory names along with weight values for them.
-weight_specoption is used: