index.html 9.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1994-2019 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 no
  7. Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  8. Texts. A copy of the license is included in the section entitled "GNU
  9. Free Documentation License". -->
  10. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  11. <head>
  12. <title>GDB&rsquo;s Obsolete Annotations: Top</title>
  13. <meta name="description" content="GDB&rsquo;s Obsolete Annotations: Top">
  14. <meta name="keywords" content="GDB&rsquo;s Obsolete Annotations: Top">
  15. <meta name="resource-type" content="document">
  16. <meta name="distribution" content="global">
  17. <meta name="Generator" content="makeinfo">
  18. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  19. <link href="#Top" rel="start" title="Top">
  20. <link href="#SEC_Contents" rel="contents" title="Table of Contents">
  21. <link href="../dir/index.html" rel="up" title="(dir)">
  22. <link href="Annotations-Overview.html#Annotations-Overview" rel="next" title="Annotations Overview">
  23. <style type="text/css">
  24. <!--
  25. a.summary-letter {text-decoration: none}
  26. blockquote.smallquotation {font-size: smaller}
  27. div.display {margin-left: 3.2em}
  28. div.example {margin-left: 3.2em}
  29. div.indentedblock {margin-left: 3.2em}
  30. div.lisp {margin-left: 3.2em}
  31. div.smalldisplay {margin-left: 3.2em}
  32. div.smallexample {margin-left: 3.2em}
  33. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  34. div.smalllisp {margin-left: 3.2em}
  35. kbd {font-style:oblique}
  36. pre.display {font-family: inherit}
  37. pre.format {font-family: inherit}
  38. pre.menu-comment {font-family: serif}
  39. pre.menu-preformatted {font-family: serif}
  40. pre.smalldisplay {font-family: inherit; font-size: smaller}
  41. pre.smallexample {font-size: smaller}
  42. pre.smallformat {font-family: inherit; font-size: smaller}
  43. pre.smalllisp {font-size: smaller}
  44. span.nocodebreak {white-space:nowrap}
  45. span.nolinebreak {white-space:nowrap}
  46. span.roman {font-family:serif; font-weight:normal}
  47. span.sansserif {font-family:sans-serif; font-weight:normal}
  48. ul.no-bullet {list-style: none}
  49. -->
  50. </style>
  51. </head>
  52. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  53. <h1 class="settitle" align="center"><small>GDB</small>&rsquo;s Obsolete Annotations</h1>
  54. <p>This file documents <small>GDB</small>&rsquo;s obsolete annotations.
  55. </p>
  56. <p>Copyright &copy; 1994-2019 Free Software Foundation, Inc.
  57. </p>
  58. <p>Permission is granted to copy, distribute and/or modify this document
  59. under the terms of the GNU Free Documentation License, Version 1.3 or
  60. any later version published by the Free Software Foundation; with no
  61. Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  62. Texts. A copy of the license is included in the section entitled &ldquo;GNU
  63. Free Documentation License&rdquo;.
  64. </p>
  65. <a name="Top"></a>
  66. <div class="header">
  67. <p>
  68. Next: <a href="Annotations-Overview.html#Annotations-Overview" accesskey="n" rel="next">Annotations Overview</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
  69. </div>
  70. <hr>
  71. <a name="GDB-Annotations"></a>
  72. <h1 class="top">GDB Annotations</h1>
  73. <p>This document describes the obsolete level two annotation interface
  74. implemented in older <small>GDB</small> versions.
  75. </p>
  76. <table class="menu" border="0" cellspacing="0">
  77. <tr><td align="left" valign="top">&bull; <a href="Annotations-Overview.html#Annotations-Overview" accesskey="1">Annotations Overview</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">What annotations are; the general syntax.
  78. </td></tr>
  79. <tr><td align="left" valign="top">&bull; <a href="Limitations.html#Limitations" accesskey="2">Limitations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Limitations of the annotation interface.
  80. </td></tr>
  81. <tr><td align="left" valign="top">&bull; <a href="Migrating-to-GDB_002fMI.html#Migrating-to-GDB_002fMI" accesskey="3">Migrating to GDB/MI</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Migrating to GDB/MI
  82. </td></tr>
  83. <tr><td align="left" valign="top">&bull; <a href="Server-Prefix.html#Server-Prefix" accesskey="4">Server Prefix</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Issuing a command without affecting user state.
  84. </td></tr>
  85. <tr><td align="left" valign="top">&bull; <a href="Value-Annotations.html#Value-Annotations" accesskey="5">Value Annotations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Values are marked as such.
  86. </td></tr>
  87. <tr><td align="left" valign="top">&bull; <a href="Frame-Annotations.html#Frame-Annotations" accesskey="6">Frame Annotations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Stack frames are annotated.
  88. </td></tr>
  89. <tr><td align="left" valign="top">&bull; <a href="Displays.html#Displays" accesskey="7">Displays</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top"><small>GDB</small> can be told to display something periodically.
  90. </td></tr>
  91. <tr><td align="left" valign="top">&bull; <a href="Prompting.html#Prompting" accesskey="8">Prompting</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Annotations marking <small>GDB</small>&rsquo;s need for input.
  92. </td></tr>
  93. <tr><td align="left" valign="top">&bull; <a href="Errors.html#Errors" accesskey="9">Errors</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Annotations for error messages.
  94. </td></tr>
  95. <tr><td align="left" valign="top">&bull; <a href="Breakpoint-Info.html#Breakpoint-Info">Breakpoint Info</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Information on breakpoints.
  96. </td></tr>
  97. <tr><td align="left" valign="top">&bull; <a href="Invalidation.html#Invalidation">Invalidation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Some annotations describe things now invalid.
  98. </td></tr>
  99. <tr><td align="left" valign="top">&bull; <a href="Annotations-for-Running.html#Annotations-for-Running">Annotations for Running</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  100. Whether the program is running, how it stopped, etc.
  101. </td></tr>
  102. <tr><td align="left" valign="top">&bull; <a href="Source-Annotations.html#Source-Annotations">Source Annotations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Annotations describing source code.
  103. </td></tr>
  104. <tr><td align="left" valign="top">&bull; <a href="Multi_002dthreaded-Apps.html#Multi_002dthreaded-Apps">Multi-threaded Apps</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">An annotation that reports multi-threadedness.
  105. </td></tr>
  106. <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
  107. </pre></th></tr><tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  108. </td></tr>
  109. </table>
  110. <a name="SEC_Contents"></a>
  111. <h2 class="contents-heading">Table of Contents</h2>
  112. <div class="contents">
  113. <ul class="no-bullet">
  114. <li><a name="toc-What-is-an-Annotation_003f" href="Annotations-Overview.html#Annotations-Overview">1 What is an Annotation?</a></li>
  115. <li><a name="toc-Limitations-of-the-Annotation-Interface" href="Limitations.html#Limitations">2 Limitations of the Annotation Interface</a>
  116. <ul class="no-bullet">
  117. <li><a name="toc-Dependant-on-CLI-output" href="Limitations.html#Dependant-on-CLI-output">2.1 Dependant on <small>CLI</small> output</a></li>
  118. <li><a name="toc-Scalability" href="Limitations.html#Scalability">2.2 Scalability</a></li>
  119. <li><a name="toc-Correctness" href="Limitations.html#Correctness">2.3 Correctness</a></li>
  120. <li><a name="toc-Reliability" href="Limitations.html#Reliability">2.4 Reliability</a></li>
  121. <li><a name="toc-Maintainability" href="Limitations.html#Maintainability">2.5 Maintainability</a></li>
  122. </ul></li>
  123. <li><a name="toc-Migrating-to-GDB_002fMI-1" href="Migrating-to-GDB_002fMI.html#Migrating-to-GDB_002fMI">3 Migrating to <small>GDB/MI</small></a></li>
  124. <li><a name="toc-The-Server-Prefix" href="Server-Prefix.html#Server-Prefix">4 The Server Prefix</a></li>
  125. <li><a name="toc-Values" href="Value-Annotations.html#Value-Annotations">5 Values</a></li>
  126. <li><a name="toc-Frames" href="Frame-Annotations.html#Frame-Annotations">6 Frames</a></li>
  127. <li><a name="toc-Displays-1" href="Displays.html#Displays">7 Displays</a></li>
  128. <li><a name="toc-Annotation-for-GDB-Input" href="Prompting.html#Prompting">8 Annotation for <small>GDB</small> Input</a></li>
  129. <li><a name="toc-Errors-1" href="Errors.html#Errors">9 Errors</a></li>
  130. <li><a name="toc-Information-on-Breakpoints" href="Breakpoint-Info.html#Breakpoint-Info">10 Information on Breakpoints</a></li>
  131. <li><a name="toc-Invalidation-Notices" href="Invalidation.html#Invalidation">11 Invalidation Notices</a></li>
  132. <li><a name="toc-Running-the-Program" href="Annotations-for-Running.html#Annotations-for-Running">12 Running the Program</a></li>
  133. <li><a name="toc-Displaying-Source" href="Source-Annotations.html#Source-Annotations">13 Displaying Source</a></li>
  134. <li><a name="toc-Multi_002dthreaded-Applications" href="Multi_002dthreaded-Apps.html#Multi_002dthreaded-Apps">14 Multi-threaded Applications</a></li>
  135. <li><a name="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">Appendix A GNU Free Documentation License</a></li>
  136. </ul>
  137. </div>
  138. <hr>
  139. <div class="header">
  140. <p>
  141. Next: <a href="Annotations-Overview.html#Annotations-Overview" accesskey="n" rel="next">Annotations Overview</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
  142. </div>
  143. </body>
  144. </html>