RealView Compilation Tools Assembler Guide: 3.1.12. Controlling the output of diagnostic messages

3.1.12. 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|gnu}

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.
gnu: Display messages using the GNU style.

Choosing the option --diag_style=ide implicitly selects the option --brief_diagnostics. Explicitly selecting --no_brief_diagnostics on the command line overrides the selection of --brief_diagnostics implied by --diag_style=ide.

Selecting either the option --diag_style=arm or the option --diag_style=gnu does not imply any selection of --brief_diagnostics.

--diag_error tag{,tag,…}

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

--diag_remark tag{,tag,…}

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

--diag_warning tag{,tag,…}

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

--diag_suppress tag{,tag,…}

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

--unsafe

Enables instructions from differing architectures to be assembled without error. 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 ...

The assembler prefix A can be used with --diag_error, --diag_remark, and --diag_warning, or when suppressing messages, for example:

armasm --diag_suppress A1293,A187 ...

Diagnostic messages can be cut and paste directly into a command line. Using the prefix letter is optional. However, if a prefix letter is included, it must match the armasm identification letter. If another prefix is found, the assembler ignores the message number.

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

Table 3.3. Severity of diagnostic messages

Severity	Description
Catastrophic error	Catastrophic errors indicate problems that cause the assembly to stop. These errors include command-line errors, internal errors, and missing include files.
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-2010 ARM. All rights reserved.	ARM DUI 0204J
Non-Confidential	ID101213
PDF version