toolchain/share/doc/as.html/Errors.html

92 lines
3.9 KiB
HTML

<html lang="en">
<head>
<title>Errors - Using as</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using as">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Overview.html#Overview" title="Overview">
<link rel="prev" href="Object.html#Object" title="Object">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This file documents the GNU Assembler "as".
Copyright (C) 1991-2019 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the
section entitled ``GNU Free Documentation License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Errors"></a>
<p>
Previous:&nbsp;<a rel="previous" accesskey="p" href="Object.html#Object">Object</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Overview.html#Overview">Overview</a>
<hr>
</div>
<h3 class="section">1.7 Error and Warning Messages</h3>
<!-- man begin DESCRIPTION -->
<p><a name="index-error-messages-40"></a><a name="index-warning-messages-41"></a><a name="index-messages-from-assembler-42"></a><samp><span class="command">as</span></samp> may write warnings and error messages to the standard error
file (usually your terminal). This should not happen when a compiler
runs <samp><span class="command">as</span></samp> automatically. Warnings report an assumption made so
that <samp><span class="command">as</span></samp> could keep assembling a flawed program; errors report a
grave problem that stops the assembly.
<!-- man end -->
<p><a name="index-format-of-warning-messages-43"></a>Warning messages have the format
<pre class="smallexample"> file_name:<b>NNN</b>:Warning Message Text
</pre>
<p class="noindent"><a name="index-file-names-and-line-numbers_002c-in-warnings_002ferrors-44"></a>(where <b>NNN</b> is a line number). If both a logical file name
(see <a href="File.html#File"><code>.file</code></a>) and a logical line number
(see <a href="Line.html#Line"><code>.line</code></a>)
have been given then they will be used, otherwise the file name and line number
in the current assembler source file will be used. The message text is
intended to be self explanatory (in the grand Unix tradition).
<p>Note the file name must be set via the logical version of the <code>.file</code>
directive, not the DWARF2 version of the <code>.file</code> directive. For example:
<pre class="smallexample"> .file 2 "bar.c"
error_assembler_source
.file "foo.c"
.line 30
error_c_source
</pre>
<p>produces this output:
<pre class="smallexample"> Assembler messages:
asm.s:2: Error: no such instruction: `error_assembler_source'
foo.c:31: Error: no such instruction: `error_c_source'
</pre>
<p><a name="index-format-of-error-messages-45"></a>Error messages have the format
<pre class="smallexample"> file_name:<b>NNN</b>:FATAL:Error Message Text
</pre>
<p>The file name and line number are derived as for warning
messages. The actual message text may be rather less explanatory
because many of them aren't supposed to happen.
</body></html>