-qminimaltoc

Category

Optimization and tuning

@PROCESS

None.

Purpose

Minimizes the number of entries in the global entity table of contents (TOC).

Syntax

Read syntax diagramSkip visual syntax diagram
        .-nominimaltoc-.   
>>- -q--+-minimaltoc---+---------------------------------------><

Defaults

-qnominimaltoc

Usage

By default, the compiler will allocate at least one TOC entry for each unique, non-automatic variable reference in your program. Currently, only 8192 TOC entries are available and duplicate entries are not discarded. This can cause errors when linking large programs in 64-bit mode if your program exceeds 8192 TOC entries.

Specifying -qminimaltoc ensures that the compiler creates only one TOC entry for each compilation unit. Specifying this option can minimize the use of available TOC entries, but its use impacts performance.

Use the -qminimaltoc option with discretion, particularly with files that contain frequently executed code.