Requesting Compiler Reports with the xi* Tools

The compiler option -opt-report (Linux* and Mac OS* X) or /Qopt-report (Windows*) generates optimization reports with different levels of detail. Related compiler options described in Compiler Reports Quick Reference allow you to specify the phase, direct output to a file (instead of stderr), and request reports from all routines with names containing a string as part of their name.

The xi* tools are used with interprocedural optimization (IPO) during the final stage of IPO compilation. You can request compiler reports to be generated during the final IPO compilation by using certain options. The supported xi* tools are:

The following tables lists the compiler report options for the xi* tools. These options are equivalent to the corresponding compiler options, but occur during the final IPO compilation.

Tool Option

Description

-qopt-report[=n]

Enables optimization report generation with different levels of detail, directed to stderr. Valid values for n are 0 through 3. By default, when you specify this option without passing a value the compiler will generate a report with a medium level of detail.

-qopt-report-file=file

Generates an optimization report and directs the report output to the specified file name. If you omit the path, the file is created in the current directory. To create the file in a different directory, specify the full path to the output file and its file name.

-qopt-report-phase=name

Specifies the optimization phase name to use when generating reports. If you do not specify a phase the compiler defaults to all. You can request a list of all available phase by using the -qopt-report-help option.

-qopt-report-routine=string

Generates reports from all routines with names containing a string as part of their name. If not specified, the compiler will generate reports on all routines.

-qopt-report-help

Displays the optimization phases available.

To understand the compiler reports, use the links provided in Compiler Reports Overview.