3.1.10. Controlling the output of diagnostic messages

There are several options that control the output of diagnostic messages:

--brief_diagnostics

Enables or disables a mode that uses a shorter form of the diagnostic output. When enabled, the original source line is not displayed and the error message text is not wrapped when it is too long to fit on a single line. The default is --no_brief_diagnostics.

--diag_style {arm|ide}

Specifies the style used to display diagnostic messages:

arm

Display messages using the ARM assembler style. This is the default if --diag_style is not specified.

ide

Include the line number and character count for the line that is in error. These values are displayed in parentheses.

--diag_error tag[, tag, ...]

Sets the diagnostic messages that have the specified tag(s) to the error severity (see Table 3.1).

--diag_remark tag[, tag, ...]

Sets the diagnostic messages that have the specified tag(s) to the remark severity (see Table 3.1).

--diag_warning tag[, tag, ...]

Sets the diagnostic messages that have the specified tag(s) to the warning severity (see Table 3.1).

--diag_suppress tag[, tag, ...]

Disables the diagnostic messages that have the specified tag(s).

--unsafe

Enables assembly of a file containing instructions that are not available on the specified architecture and processor. It changes corresponding error messages to warning messages. It also suppresses warnings about operator precedence (see Binary operators).

Four of the --diag_ options require a tag, that is the number of the message to be suppressed. More than one tag can be specified. For example, to suppress the warning messages that have numbers 1293 and 187, use the following command:


armasm --diag_suppress 1293,187 ...

A tag contains only digits. Omit alphabetic characters, if any, from message numbers.

Table 3.1 explains the meaning of the term severity used in the option descriptions.

Table 3.1. Severity of diagnostic messages

SeverityDescription

Catastrophic error

Catastrophic errors indicate problems that cause the assembly to stop. These errors include command-line errors, internal errors, and missing include files. If multiple source files are being assembled, then no further source files are assembled.

Error

Errors indicate violations in the syntactic or semantic rules of assembly language. Assembly continues, but object code is not generated.

Warning

Warnings indicate unusual conditions in your code that might indicate a problem. Assembly continues, and object code is generated unless any problems with an Error severity are detected.

Remark

Remarks indicate common, but not recommended, use of assembly language. These diagnostics are not issued by default. Assembly continues, and object code is generated unless any problems with an Error severity are detected.

Copyright © 2002-2005 ARM Limited. All rights reserved.ARM DUI 0204F
Non-Confidential