Internal-Errors.html 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
  2. <html>
  3. <!-- Created on December 10, 2012 by texi2html 1.82
  4. texi2html was written by:
  5. Lionel Cons <[email protected]> (original author)
  6. Karl Berry <[email protected]>
  7. Olaf Bachmann <[email protected]>
  8. and many others.
  9. Maintained by: Many creative people.
  10. Send bugs and suggestions to <[email protected]>
  11. -->
  12. <head>
  13. <title>avram - a virtual machine code interpreter: 1.6.1 Internal Errors</title>
  14. <meta name="description" content="avram - a virtual machine code interpreter: 1.6.1 Internal Errors">
  15. <meta name="keywords" content="avram - a virtual machine code interpreter: 1.6.1 Internal Errors">
  16. <meta name="resource-type" content="document">
  17. <meta name="distribution" content="global">
  18. <meta name="Generator" content="texi2html 1.82">
  19. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  20. <style type="text/css">
  21. <!--
  22. a.summary-letter {text-decoration: none}
  23. blockquote.smallquotation {font-size: smaller}
  24. pre.display {font-family: serif}
  25. pre.format {font-family: serif}
  26. pre.menu-comment {font-family: serif}
  27. pre.menu-preformatted {font-family: serif}
  28. pre.smalldisplay {font-family: serif; font-size: smaller}
  29. pre.smallexample {font-size: smaller}
  30. pre.smallformat {font-family: serif; font-size: smaller}
  31. pre.smalllisp {font-size: smaller}
  32. span.roman {font-family:serif; font-weight:normal;}
  33. span.sansserif {font-family:sans-serif; font-weight:normal;}
  34. ul.toc {list-style: none}
  35. -->
  36. </style>
  37. </head>
  38. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  39. <a name="Internal-Errors"></a>
  40. <table cellpadding="1" cellspacing="1" border="0">
  41. <tr><td valign="middle" align="left">[<a href="Diagnostics.html#Diagnostics" title="Previous section in reading order"> &lt; </a>]</td>
  42. <td valign="middle" align="left">[<a href="i_002fo-Errors.html#i_002fo-Errors" title="Next section in reading order"> &gt; </a>]</td>
  43. <td valign="middle" align="left"> &nbsp; </td>
  44. <td valign="middle" align="left">[<a href="User-Manual.html#User-Manual" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
  45. <td valign="middle" align="left">[<a href="Diagnostics.html#Diagnostics" title="Up section"> Up </a>]</td>
  46. <td valign="middle" align="left">[<a href="Virtual-Machine-Specification.html#Virtual-Machine-Specification" title="Next chapter"> &gt;&gt; </a>]</td>
  47. <td valign="middle" align="left"> &nbsp; </td>
  48. <td valign="middle" align="left"> &nbsp; </td>
  49. <td valign="middle" align="left"> &nbsp; </td>
  50. <td valign="middle" align="left"> &nbsp; </td>
  51. <td valign="middle" align="left">[<a href="avram.html#Top" title="Cover (top) of document">Top</a>]</td>
  52. <td valign="middle" align="left">[<a href="avram_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
  53. <td valign="middle" align="left">[<a href="Function-Index.html#Function-Index" title="Index">Index</a>]</td>
  54. <td valign="middle" align="left">[<a href="avram_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
  55. </tr></table>
  56. <hr size="1">
  57. <a name="Internal-Errors-1"></a>
  58. <h3 class="subsection">1.6.1 Internal Errors</h3>
  59. <a name="index-internal-errors"></a>
  60. <p>Internal errors should never occur unless the
  61. <code>avram</code> source code has been carelessly modified, except as noted
  62. in <a href="Bugs.html#Bugs">Bugs</a>. There are two kinds.
  63. </p>
  64. <dl compact="compact">
  65. <dt> <code><var>application-name</var>: virtual machine internal error (code <var>nn</var>)</code></dt>
  66. <dd><p>Most internal errors would be reported by a message of this form
  67. if they were to occur. It indicates that some required invariant was
  68. not maintained. In such cases, the program terminates immediately, and
  69. any results already produced are suspect.
  70. </p></dd>
  71. <dt> <code><var>application-name</var>: <var>nn</var> unreclaimed <var>struct-names</var></code></dt>
  72. <dd><p>A message of this form could be printed at the end of an otherwise successful
  73. run. <code>avram</code> maintains a count of the number of units allocated
  74. for various data structures, and checks that they are all reclaimed
  75. eventually as a safeguard against memory leaks. This message indicates
  76. that some memory remains unaccounted for.
  77. </p></dd>
  78. </dl>
  79. <a name="index-bug-reports"></a>
  80. <a name="index-email"></a>
  81. <a name="index-author"></a>
  82. <p>If a repeatable internal error is discovered, please email a bug
  83. report and a small representative test case to
  84. <a href="mailto:[email protected]">[email protected]</a> or file an issue on the Avram
  85. github page. Include the version number of <code>avram</code>, which you can
  86. get by running <kbd>avram --version</kbd>.
  87. </p>
  88. <hr size="1">
  89. <table cellpadding="1" cellspacing="1" border="0">
  90. <tr><td valign="middle" align="left">[<a href="Diagnostics.html#Diagnostics" title="Previous section in reading order"> &lt; </a>]</td>
  91. <td valign="middle" align="left">[<a href="i_002fo-Errors.html#i_002fo-Errors" title="Next section in reading order"> &gt; </a>]</td>
  92. <td valign="middle" align="left"> &nbsp; </td>
  93. <td valign="middle" align="left">[<a href="User-Manual.html#User-Manual" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
  94. <td valign="middle" align="left">[<a href="Diagnostics.html#Diagnostics" title="Up section"> Up </a>]</td>
  95. <td valign="middle" align="left">[<a href="Virtual-Machine-Specification.html#Virtual-Machine-Specification" title="Next chapter"> &gt;&gt; </a>]</td>
  96. <td valign="middle" align="left"> &nbsp; </td>
  97. <td valign="middle" align="left"> &nbsp; </td>
  98. <td valign="middle" align="left"> &nbsp; </td>
  99. <td valign="middle" align="left"> &nbsp; </td>
  100. <td valign="middle" align="left">[<a href="avram.html#Top" title="Cover (top) of document">Top</a>]</td>
  101. <td valign="middle" align="left">[<a href="avram_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
  102. <td valign="middle" align="left">[<a href="Function-Index.html#Function-Index" title="Index">Index</a>]</td>
  103. <td valign="middle" align="left">[<a href="avram_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
  104. </tr></table>
  105. <p>
  106. <font size="-1">
  107. This document was generated on <i>December 10, 2012</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
  108. </font>
  109. <br>
  110. </p>
  111. </body>
  112. </html>