Overview.html 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1992-2019 Free Software Foundation, Inc.
  4. Contributed by Cygnus Support. Written by Julia Menapace, Jim Kingdon,
  5. and David MacKenzie.
  6. Permission is granted to copy, distribute and/or modify this document
  7. under the terms of the GNU Free Documentation License, Version 1.3 or
  8. any later version published by the Free Software Foundation; with no
  9. Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  10. Texts. A copy of the license is included in the section entitled "GNU
  11. Free Documentation License". -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>STABS: Overview</title>
  15. <meta name="description" content="STABS: Overview">
  16. <meta name="keywords" content="STABS: Overview">
  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="Symbol-Types-Index.html#Symbol-Types-Index" rel="index" title="Symbol Types Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="index.html#Top" rel="up" title="Top">
  25. <link href="Flow.html#Flow" rel="next" title="Flow">
  26. <link href="index.html#Top" rel="prev" title="Top">
  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="Overview"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Program-Structure.html#Program-Structure" accesskey="n" rel="next">Program Structure</a>, Previous: <a href="index.html#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Symbol-Types-Index.html#Symbol-Types-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Overview-of-Stabs"></a>
  64. <h2 class="chapter">1 Overview of Stabs</h2>
  65. <p><em>Stabs</em> refers to a format for information that describes a program
  66. to a debugger. This format was apparently invented by
  67. Peter Kessler at
  68. the University of California at Berkeley, for the <code>pdx</code> Pascal
  69. debugger; the format has spread widely since then.
  70. </p>
  71. <p>This document is one of the few published sources of documentation on
  72. stabs. It is believed to be comprehensive for stabs used by C. The
  73. lists of symbol descriptors (see <a href="Symbol-Descriptors.html#Symbol-Descriptors">Symbol Descriptors</a>) and type
  74. descriptors (see <a href="Type-Descriptors.html#Type-Descriptors">Type Descriptors</a>) are believed to be completely
  75. comprehensive. Stabs for COBOL-specific features and for variant
  76. records (used by Pascal and Modula-2) are poorly documented here.
  77. </p>
  78. <p>Other sources of information on stabs are <cite>Dbx and Dbxtool
  79. Interfaces</cite>, 2nd edition, by Sun, 1988, and <cite>AIX Version 3.2 Files
  80. Reference</cite>, Fourth Edition, September 1992, &quot;dbx Stabstring Grammar&quot; in
  81. the a.out section, page 2-31. This document is believed to incorporate
  82. the information from those two sources except where it explicitly directs
  83. you to them for more information.
  84. </p>
  85. <table class="menu" border="0" cellspacing="0">
  86. <tr><td align="left" valign="top">&bull; <a href="Flow.html#Flow" accesskey="1">Flow</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Overview of debugging information flow
  87. </td></tr>
  88. <tr><td align="left" valign="top">&bull; <a href="Stabs-Format.html#Stabs-Format" accesskey="2">Stabs Format</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Overview of stab format
  89. </td></tr>
  90. <tr><td align="left" valign="top">&bull; <a href="String-Field.html#String-Field" accesskey="3">String Field</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The string field
  91. </td></tr>
  92. <tr><td align="left" valign="top">&bull; <a href="C-Example.html#C-Example" accesskey="4">C Example</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">A simple example in C source
  93. </td></tr>
  94. <tr><td align="left" valign="top">&bull; <a href="Assembly-Code.html#Assembly-Code" accesskey="5">Assembly Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The simple example at the assembly level
  95. </td></tr>
  96. </table>
  97. </body>
  98. </html>