-qlistopt

Category

Listings, messages, and compiler information

Purpose

Produces a compiler listing file that includes all options in effect at the time of compiler invocation.

When listopt is in effect, a listing file is generated with a .lst suffix for each source file named on the command line. The listing shows options in effect as set by the compiler defaults, the configuration file, and command line settings.

Syntax

Read syntax diagramSkip visual syntax diagram
        .-nolistopt-.   
>>- -q--+-listopt---+------------------------------------------><

@PROCESS:

@PROCESS LISTOPT | NOLISTOPT

Defaults

-qnolistopt

Usage

You can use the option listing during debugging to check whether a problem occurs under a particular combination of compiler options, or during performance testing to record the optimization options in effect for a particular compilation.

Options that are always displayed in the listing include:
  • All "on/off" options that are on by default: for example, -qobject
  • All "on/off" options that are explicitly turned off through the configuration file, command-line options, or @PROCESS directives
  • All options that take arbitrary numeric arguments (typically sizes)
  • All options that have multiple suboptions

The -qnoprint compiler option overrides this option.

Related information