5.8.57. OPT directive

The OPT directive sets listing options from within the source code.

Syntax

The syntax of OPT is:

OPT n

where:

n

is the OPT directive setting. Table 5.3 lists valid settings.

Table 5.3. OPT directive settings

OPT nEffect

1

Turns on normal listing.

2

Turns off normal listing.

4

Page throw. Issues an immediate formfeed and starts a new page.

8

Resets the line number counter to zero.

16

Turns on listing for SET, GBL and LCL directives.

32

Turns off listing for SET, GBL and LCL directives.

64

Turns on listing of macro expansions.

128

Turns off listing of macro expansions.

256

Turns on listing of macro invocations.

512

Turns off listing of macro invocations.

1024

Turns on the first pass listing.

2048

Turns off the first pass listing.

4096

Turns on listing of conditional directives.

8192

Turns off listing of conditional directives.

16384

Turns on listing of MEND directives.

32768

Turns off listing of MEND directives.

Usage

Specify the -list assembler option to turn on listing.

By default the -list option produces a normal listing that includes variable declarations, macro expansions, call-conditioned directives, and MEND directives. The listing is produced on the second pass only. Use the OPT directive to modify the default listing options from within your code. Refer to Command syntax for information on the -list option.

You can use OPT to format code listings. For example, you can specify a new page before functions and areas.

Example

		AREA 		Example, CODE, READONLY
start		; code	 
		; code
		BL		func1
		; code
		OPT 4					; places a page break before func1
func1		; code
Copyright © 1997, 1998 ARM Limited. All rights reserved.ARM DUI 0041C
Non-Confidential