Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

qopt-report, Qopt-report

Enables the generation of a textual file that includes optimization transformation information.

Syntax

Linux:

-qopt-report[=arg]

Windows:

/Qopt-report[=arg]

Arguments

arg

Determines the level of detail in the report. Possible values are:

0

Disables generation of an optimization report. This is the default when the option is not specified.

1 or low

Tells the compiler to only emit positive remarks. That is, report only the transformations that actually happened.

2 or medium

Tells the compiler to create a report with low details, plus emit negative remarks with a reason why the transformation did not happen. This is the default if you do not specify arg.

3 or high

Tells the compiler to create a report with medium details, plus all other details.

Default

OFF

No optimization report is generated.

Description

This option enables the generation of a textual file that includes optimization transformation information.

The file provides the optimization information for the source file being compiled. For example:

ifx -fiopenmp -qopt-report foo.f90

This command will generate a file called foo.optrpt containing the optimization report messages.

When offloading is enabled, two optimization reports are generated:

  • A host-side optimization report named foo.optrpt, when there is only CPU compilation.

  • A device-side optimization report with the form foo-xxx-yyy.optrpt, where xxx is either "sycl" or "openmp" depending on the kind of offload, and "yyy" is the name of the offload target.

    For example, if option -fopenmp-targets=spir64 is specified on the compile, the report is named foo-openmp-spir64.optrpt.

NOTE:

In releases prior to 2025.0, this option also produced a YAML-formatted optimization report containing LLVM community optimization remarks. Beginning with release 2025.0, the YAML file will no longer be produced by this option.

However, you can still produce the YAML report using the Clang option -fsave-optimization-record.

IDE Equivalent

None

Alternate Options

None