Errors.html 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- This file documents the GNU Assembler "as".
  4. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: Errors</title>
  15. <meta name="description" content="Using as: Errors">
  16. <meta name="keywords" content="Using as: Errors">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="Overview.html#Overview" rel="up" title="Overview">
  25. <link href="Invoking.html#Invoking" rel="next" title="Invoking">
  26. <link href="Object.html#Object" rel="prev" title="Object">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="Errors"></a>
  58. <div class="header">
  59. <p>
  60. Previous: <a href="Object.html#Object" accesskey="p" rel="prev">Object</a>, Up: <a href="Overview.html#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Error-and-Warning-Messages"></a>
  64. <h3 class="section">1.7 Error and Warning Messages</h3>
  65. <a name="index-error-messages"></a>
  66. <a name="index-warning-messages"></a>
  67. <a name="index-messages-from-assembler"></a>
  68. <p><code>as</code> may write warnings and error messages to the standard error
  69. file (usually your terminal). This should not happen when a compiler
  70. runs <code>as</code> automatically. Warnings report an assumption made so
  71. that <code>as</code> could keep assembling a flawed program; errors report a
  72. grave problem that stops the assembly.
  73. </p>
  74. <a name="index-format-of-warning-messages"></a>
  75. <p>Warning messages have the format
  76. </p>
  77. <div class="smallexample">
  78. <pre class="smallexample">file_name:<b>NNN</b>:Warning Message Text
  79. </pre></div>
  80. <a name="index-file-names-and-line-numbers_002c-in-warnings_002ferrors"></a>
  81. <p>(where <b>NNN</b> is a line number). If both a logical file name
  82. (see <a href="File.html#File"><code>.file</code></a>) and a logical line number
  83. (see <a href="Line.html#Line"><code>.line</code></a>)
  84. have been given then they will be used, otherwise the file name and line number
  85. in the current assembler source file will be used. The message text is
  86. intended to be self explanatory (in the grand Unix tradition).
  87. </p>
  88. <p>Note the file name must be set via the logical version of the <code>.file</code>
  89. directive, not the DWARF2 version of the <code>.file</code> directive. For example:
  90. </p>
  91. <div class="smallexample">
  92. <pre class="smallexample"> .file 2 &quot;bar.c&quot;
  93. error_assembler_source
  94. .file &quot;foo.c&quot;
  95. .line 30
  96. error_c_source
  97. </pre></div>
  98. <p>produces this output:
  99. </p>
  100. <div class="smallexample">
  101. <pre class="smallexample"> Assembler messages:
  102. asm.s:2: Error: no such instruction: `error_assembler_source'
  103. foo.c:31: Error: no such instruction: `error_c_source'
  104. </pre></div>
  105. <a name="index-format-of-error-messages"></a>
  106. <p>Error messages have the format
  107. </p>
  108. <div class="smallexample">
  109. <pre class="smallexample">file_name:<b>NNN</b>:FATAL:Error Message Text
  110. </pre></div>
  111. <p>The file name and line number are derived as for warning
  112. messages. The actual message text may be rather less explanatory
  113. because many of them aren&rsquo;t supposed to happen.
  114. </p>
  115. </body>
  116. </html>