symtab

Option Type Default Value #pragma options C C++
-qoption - - x x

Syntax

    -qsymtab=options 

Purpose

Controls symbol table.

The following table describes the effect of specifying -qsymtabt=option for each of the following options.

Option Effect
unref Specifies that all typedef declarations, struct, union, and enum type definitions are included for processing by the Distributed Debugger.

Use this option with the -g option to produce additional debugging information for use with the Distributed Debugger.

When you specify the -g option, debugging information is included in the object file. To minimize the size of object and executable files, the compiler only includes information for symbols that are referenced. Debugging information is not produced for unreferenced arrays, pointers, or file-scope variables unless -qsymtab=unref is specified.

Using -qsymtab=unref may make your object and executable files larger.

static Adds user-defined, nonexternal names that have a persistent storage class, such as initialized and uninitialized static variables, to the name list (the symbol table of xcoff objects).

The default is to not add static variables to the symbol table. 

Examples
To compile myprogram.C so that static symbols are added to the symbol table, enter:

xlC myprogram.C -qsymtab=static

To include all symbols in myprogram.C in the symbols table for use with the Distributed Debugger, enter:

xlC myprogram.C -g -qsymtab=unref


List of Batch Compiler Options and Their Defaults
Options that Specify Debugging Features
Equivalent Batch Compile-Link and Incremental Build Options