ARM Software Development Toolkit Reference Guide 5.8.57. OPT directive

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 n	Effect
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
PDF version