 RealView Linker and Utilities Guide |
|
| Controlling linker diagnostics2.2.12. Controlling linker diagnosticsThese options control how the linker emits diagnostics: ‑‑diag_style arm|ide|gnuChange the formatting of warning and error messages. ‑‑diag_style arm is the default, ‑‑diag_style gnu matches the format reported by gcc, and ‑‑diag_style ide matches the format reported by Microsoft Visual Studio. ‑‑diag_suppress taglistDisables all diagnostic messages that have the specified tag(s). This option requires a comma-separated list of diagnostic message numbers that specifies the messages that must be suppressed. For example, to suppress the warning messages that have numbers L6314W and L6305W, use the following command:
armlink ‑‑diag_suppress L6314,L6305 ...
‑‑diag_warning taglistSets diagnostic messages that have the specified tag(s) to be displayed as warning messages, for example, where you want to downgrade an error message. This option requires a comma-separated list of diagnostic message numbers that specifies the messages that must be downgraded. ‑‑errors fileRedirects the diagnostics from the standard error stream to file. The specified file is created at the start of the link stage. If a file of the same name already exists, it is cleared. If file is specified without path information, it is created in the current directory. ‑‑list fileRedirects the diagnostics from output of the ‑‑info, ‑‑map, ‑‑symbols, --verbose, ‑‑xref, ‑‑xreffrom, and ‑‑xrefto commands to file. The specified file is created when diagnostics are output. If a file of the same name already exists, it is overwritten. However, if diagnostics are not output, a file is not created. In this case, the contents of any existing file with the same name remain unchanged. If file is specified without path information, it is created in the output directory, that is, the directory where the output image is being written. ‑‑verbosePrints detailed information about the link operation, including the objects that are included and the libraries from which they are taken. Because this output is typically quite long, you might want to use this command with the ‑‑list file command to redirect the information to file. Use ‑‑verbose to output diagnostics to stdout.
Prefix letters in diagnostic messagesThe RVCT tools automatically insert an identification letter to diagnostic messages, as described in Table 2.1. Using these prefix letters enables the RVCT tools to use overlapping message ranges. Table 2.1. Identifying diagnostic messages | Prefix letter | RVCT tool |
|---|
C | armcc | A | armasm | L | armlink or armar | Q | fromelf |
The following rules apply: All the RVCT tools act on a message number without a prefix. A message number with a prefix is only acted on by the tool with the matching prefix. A tool does not act on a message with a non matching prefix.
Thus, the linker prefix L can be used with ‑‑diag_error, ‑‑diag_remark, and ‑‑diag_warning, or when suppressing messages, for example:
armlink ‑‑diag_suppress L6314,L6305 ...
|
|