-qlist

Category

Listings, messages, and compiler information

Pragma equivalent

#pragma options [no]list

Purpose

Produces a compiler listing file that includes an object listing.

When list is in effect, a listing file is generated with a .lst suffix for each source file named on the command line. For details of the contents of the listing file, see Compiler listings.

You can use the object or assembly listing to help understand the performance characteristics of the generated code and to diagnose execution problems.

Syntax

Read syntax diagramSkip visual syntax diagram
        .-nolist--------------------.   
>>- -q--+-list--+-----------------+-+--------------------------><
                |    .-nooffset-. |     
                '-=--+-offset---+-'     

Defaults

-qnolist

Parameters

offset | nooffset
Changes the offset of the PDEF header from 00000 to the offset of the start of the text area. Specifying the option allows any program reading the .lst file to add the value of the PDEF and the line in question, and come up with the same value whether offset or nooffset is specified. The offset suboption is only relevant if there are multiple procedures in a compilation unit.

Specifying list without the suboption is equivalent to list=nooffset.

Usage

The -qnoprint compiler option overrides this option.

Predefined macros

None.

Examples

To compile myprogram.c and to produce a listing (.lst) file that includes an object listing, enter:
xlc myprogram.c -qlist

Related information