-qdbgfmt

Pragma equivalent

None.

Purpose

Specifies the format for the debugging information in object files.

DWARF is a standard that defines the format of debugging information in programs. It is used on a wide variety of operating systems and is extensible and compact.

Syntax


                   .-stabstring-.   
>>- -q--dbgfmt--=--+-dwarf------+------------------------------><
                   '-dwarf4-----'

Defaults

-qdbgfmt=stabstring

Parameters

stabstring: Generates debugging information in stabstring format.
Note: This suboption does not generate debugging information for C11 features. Use the dwarf or dwarf4 suboption instead for these features.
dwarf: Generates debugging information in DWARF 3 format.
dwarf4: Generates debugging information in DWARF 4 format.

Notes:

To use -qdbgfmt=dwarf or -qdbgfmt=dwarf4, the program must be compiled and linked on AIX® V7.1 or above.
To debug programs built with -qdbgfmt=dwarf or -qdbgfmt=dwarf4, a DWARF-enabled debugger such as dbx is required.

Usage

-qdbgfmt does not imply any of the debugging options, such as -g. For example:

To generate debugging information in stabstring format, use -g -qdbgfmt=stabstring.
To generate debugging information in DWARF 3 format, use -g -qdbgfmt=dwarf.
To generate debugging information in DWARF 4 format, use -g -qdbgfmt=dwarf4.

-qdbgfmt also applies to -qlinedebug, which generates a subset of -g information. For example, you can use -qlinedebug -qdbgfmt=dwarf to generate line number information in DWARF 3 format.