Troubleshooting.html 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1988-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>GNU Compiler Collection (GCC) Internals: Troubleshooting</title>
  20. <meta name="description" content="GNU Compiler Collection (GCC) Internals: Troubleshooting">
  21. <meta name="keywords" content="GNU Compiler Collection (GCC) Internals: Troubleshooting">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Type-Information.html#Type-Information" rel="up" title="Type Information">
  30. <link href="Plugins.html#Plugins" rel="next" title="Plugins">
  31. <link href="Invoking-the-garbage-collector.html#Invoking-the-garbage-collector" rel="prev" title="Invoking the garbage collector">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style:oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="Troubleshooting"></a>
  63. <div class="header">
  64. <p>
  65. Previous: <a href="Invoking-the-garbage-collector.html#Invoking-the-garbage-collector" accesskey="p" rel="prev">Invoking the garbage collector</a>, Up: <a href="Type-Information.html#Type-Information" accesskey="u" rel="up">Type Information</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  66. </div>
  67. <hr>
  68. <a name="Troubleshooting-the-garbage-collector"></a>
  69. <h3 class="section">22.7 Troubleshooting the garbage collector</h3>
  70. <a name="index-garbage-collector_002c-troubleshooting"></a>
  71. <p>With the current garbage collector implementation, most issues should
  72. show up as GCC compilation errors. Some of the most commonly
  73. encountered issues are described below.
  74. </p>
  75. <ul>
  76. <li> Gengtype does not produce allocators for a <code>GTY</code>-marked type.
  77. Gengtype checks if there is at least one possible path from GC roots to
  78. at least one instance of each type before outputting allocators. If
  79. there is no such path, the <code>GTY</code> markers will be ignored and no
  80. allocators will be output. Solve this by making sure that there exists
  81. at least one such path. If creating it is unfeasible or raises a &ldquo;code
  82. smell&rdquo;, consider if you really must use GC for allocating such type.
  83. </li><li> Link-time errors about undefined <code>gt_ggc_r_foo_bar</code> and
  84. similarly-named symbols. Check if your <samp>foo_bar</samp> source file has
  85. <code>#include &quot;gt-foo_bar.h&quot;</code> as its very last line.
  86. </li></ul>
  87. </body>
  88. </html>