Intel® Fortran Compiler Classic and Intel® Fortran Compiler Developer Guide and Reference

ID 767251
Date 9/08/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Request Compiler Reports with the xi* Tools

The compiler options qopt-report (Linux* and macOS) and [Q]opt-report (Windows*) generate optimization reports with different levels of detail. Related compiler options, listed under Optimization Report Options, allow you to specify the phase, direct output to a file (instead of stderr), and request reports from all routines with names containing a specific 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:

Linux and macOS

  • Linker: xild
  • Library: xiar, xilibtool (macOS only)

Windows

  • Linker: xilink
  • Library: xilib

The following table lists the compiler report options that can be used with the xi* tools during the final IPO compilation:

Linux and macOS

Windows

Description

-qopt-report[=n]

/Qopt-report[:n]

Enables optimization report generation with different levels of detail. Valid values for n are 0 through 5. By default, when you specify this option without passing a value the compiler will generate a report with a medium level of detail. Higher numbers give greater levels of detail.

-qopt-report-file=filename

/Qopt-report-file:filename

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[=list]

/Qopt-report-phase[:list]

Specifies a comma separated list of optimization phases 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 phases by using the [Q]opt-report-help option.

To generate a report for the IPO phase, use -qopt-report-phase=ipo or /Qopt-report-phase:ipo .

Available for ifort only.

-qopt-report-routine=substring

/Qopt-report-routine:substring

Generates reports for all routines with names containing substring as part of their name. You can also specify a sequence of substrings separated by commas. If you do this, the compiler generates an optimization report for each of the routines whose name contains one or more of these substrings.

If substring is not specified, the compiler generates reports on all routines.

Available for ifort only.

-qopt-report-filter=string

/Qopt-report-filter:string

Tells the compiler to find the indicated parts of your application specified by string, and generate optimization reports for them.

If both -qopt-report-routines=string1 and qopt-report-filter=string2 are specified, it is treated as -qopt-report-filter=string1;string2.

Available for ifort only.

-qopt-report-help

/Qopt-report-help

Displays the optimization phases available to use when using the -qopt-report-phase (Linux and macOS) or [q or Q]opt-report-phase (Windows) option.

Available for ifort only.

-qopt-report-names

/Qopt-report-names

Specifies whether mangled or unmangled names appear in the optimization report. If this option is not specified, unmangled names are used by default.

If you specify mangled, encoding (also known as decoration) is added to names in the optimization report. This is appropriate when you want to match annotations with the assembly listing. If you specify unmangled, no encoding (or decoration) is added to names in the optimization report. This is appropriate when you want to match annotations with the source listing. If you use this option, you do not have to specify the -qopt-report (Linux and macOS) or /Qopt-report (Windows) option.

Available for ifort only.