.toc pseudo-op

Purpose

Defines the table of contents of a module.

Syntax

.toc

Description

The .toc pseudo-op defines the table of contents (TOC) anchor of a module. Entries in the TOC section can be declared with .tc pseudo-op within the scope of the .toc pseudo-op. The .toc pseudo-op has scope similar to that of a .csect pseudo-op. The TOC can be continued throughout the assembly wherever a .toc appears.

Examples

The following example illustrates the use of the .toc pseudo-op:


.toc
# Create two TOC entries. The first entry, named proga, 
# is of type TC and contains the address of proga[RW] and dataA.

# The second entry, named progb, is of type TC and contains 
# the address of progb[PR] and progc[PR].

T.proga:          .tc proga[TC],proga[RW],dataA
T.progb:          .tc progb[TC],progb[PR],progc[PR]

.csect proga[RW]

# A .csect should precede any statements following a .toc/.tc 
# section which do not belong in the TOC.

.long TOC[tc0]

# The address of the TOC for this module is placed in a fullword.