visus
/
toolchain-gcc-arm-embedded
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 Commits
1 Branch
Branch: main
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'main'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gccint/All-Debuggers.html

148 lines
6.9KB
Raw Permalink Blame History 

  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-2020 Free Software Foundation, Inc.

  4. 

  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 or

  7. any later version published by the Free Software Foundation; with the

  8. Invariant Sections being "Funding Free Software", the Front-Cover

  9. Texts being (a) (see below), and with the Back-Cover Texts being (b)

  10. (see below).  A copy of the license is included in the section entitled

  11. "GNU Free Documentation License".

  12. 

  13. (a) The FSF's Front-Cover Text is:

  14. 

  15. A GNU Manual

  16. 

  17. (b) The FSF's Back-Cover Text is:

  18. 

  19. You have freedom to copy and modify this GNU Manual, like GNU

  20.      software.  Copies published by the Free Software Foundation raise

  21.      funds for GNU development. -->

  22. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->

  23. <head>

  24. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  25. <title>All Debuggers (GNU Compiler Collection (GCC) Internals)</title>

  26. 

  27. <meta name="description" content="All Debuggers (GNU Compiler Collection (GCC) Internals)">

  28. <meta name="keywords" content="All Debuggers (GNU Compiler Collection (GCC) Internals)">

  29. <meta name="resource-type" content="document">

  30. <meta name="distribution" content="global">

  31. <meta name="Generator" content="makeinfo">

  32. <link href="index.html#Top" rel="start" title="Top">

  33. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">

  34. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">

  35. <link href="Debugging-Info.html#Debugging-Info" rel="up" title="Debugging Info">

  36. <link href="DBX-Options.html#DBX-Options" rel="next" title="DBX Options">

  37. <link href="Debugging-Info.html#Debugging-Info" rel="prev" title="Debugging Info">

  38. <style type="text/css">

  39. <!--

  40. a.summary-letter {text-decoration: none}

  41. blockquote.indentedblock {margin-right: 0em}

  42. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}

  43. blockquote.smallquotation {font-size: smaller}

  44. div.display {margin-left: 3.2em}

  45. div.example {margin-left: 3.2em}

  46. div.lisp {margin-left: 3.2em}

  47. div.smalldisplay {margin-left: 3.2em}

  48. div.smallexample {margin-left: 3.2em}

  49. div.smalllisp {margin-left: 3.2em}

  50. kbd {font-style: oblique}

  51. pre.display {font-family: inherit}

  52. pre.format {font-family: inherit}

  53. pre.menu-comment {font-family: serif}

  54. pre.menu-preformatted {font-family: serif}

  55. pre.smalldisplay {font-family: inherit; font-size: smaller}

  56. pre.smallexample {font-size: smaller}

  57. pre.smallformat {font-family: inherit; font-size: smaller}

  58. pre.smalllisp {font-size: smaller}

  59. span.nolinebreak {white-space: nowrap}

  60. span.roman {font-family: initial; font-weight: normal}

  61. span.sansserif {font-family: sans-serif; font-weight: normal}

  62. ul.no-bullet {list-style: none}

  63. -->

  64. </style>

  65. 

  66. 

  67. </head>

  68. 

  69. <body lang="en">

  70. <a name="All-Debuggers"></a>

  71. <div class="header">

  72. <p>

  73. Next: <a href="DBX-Options.html#DBX-Options" accesskey="n" rel="next">DBX Options</a>, Up: <a href="Debugging-Info.html#Debugging-Info" accesskey="u" rel="up">Debugging Info</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>

  74. </div>

  75. <hr>

  76. <a name="Macros-Affecting-All-Debugging-Formats"></a>

  77. <h4 class="subsection">18.21.1 Macros Affecting All Debugging Formats</h4>

  78. 

  79. <p>These macros affect all debugging formats.

  80. </p>

  81. <dl>

  82. <dt><a name="index-DBX_005fREGISTER_005fNUMBER"></a>Macro: <strong>DBX_REGISTER_NUMBER</strong> <em>(<var>regno</var>)</em></dt>

  83. <dd><p>A C expression that returns the DBX register number for the compiler

  84. register number <var>regno</var>.  In the default macro provided, the value

  85. of this expression will be <var>regno</var> itself.  But sometimes there are

  86. some registers that the compiler knows about and DBX does not, or vice

  87. versa.  In such cases, some register may need to have one number in the

  88. compiler and another for DBX.

  89. </p>

  90. <p>If two registers have consecutive numbers inside GCC, and they can be

  91. used as a pair to hold a multiword value, then they <em>must</em> have

  92. consecutive numbers after renumbering with <code>DBX_REGISTER_NUMBER</code>.

  93. Otherwise, debuggers will be unable to access such a pair, because they

  94. expect register pairs to be consecutive in their own numbering scheme.

  95. </p>

  96. <p>If you find yourself defining <code>DBX_REGISTER_NUMBER</code> in way that

  97. does not preserve register pairs, then what you must do instead is

  98. redefine the actual register numbering scheme.

  99. </p></dd></dl>

  100. 

  101. <dl>

  102. <dt><a name="index-DEBUGGER_005fAUTO_005fOFFSET"></a>Macro: <strong>DEBUGGER_AUTO_OFFSET</strong> <em>(<var>x</var>)</em></dt>

  103. <dd><p>A C expression that returns the integer offset value for an automatic

  104. variable having address <var>x</var> (an RTL expression).  The default

  105. computation assumes that <var>x</var> is based on the frame-pointer and

  106. gives the offset from the frame-pointer.  This is required for targets

  107. that produce debugging output for DBX and allow the frame-pointer to be

  108. eliminated when the <samp>-g</samp> option is used.

  109. </p></dd></dl>

  110. 

  111. <dl>

  112. <dt><a name="index-DEBUGGER_005fARG_005fOFFSET"></a>Macro: <strong>DEBUGGER_ARG_OFFSET</strong> <em>(<var>offset</var>, <var>x</var>)</em></dt>

  113. <dd><p>A C expression that returns the integer offset value for an argument

  114. having address <var>x</var> (an RTL expression).  The nominal offset is

  115. <var>offset</var>.

  116. </p></dd></dl>

  117. 

  118. <dl>

  119. <dt><a name="index-PREFERRED_005fDEBUGGING_005fTYPE"></a>Macro: <strong>PREFERRED_DEBUGGING_TYPE</strong></dt>

  120. <dd><p>A C expression that returns the type of debugging output GCC should

  121. produce when the user specifies just <samp>-g</samp>.  Define

  122. this if you have arranged for GCC to support more than one format of

  123. debugging output.  Currently, the allowable values are <code>DBX_DEBUG</code>,

  124. <code>DWARF2_DEBUG</code>, <code>XCOFF_DEBUG</code>, <code>VMS_DEBUG</code>,

  125. and <code>VMS_AND_DWARF2_DEBUG</code>.

  126. </p>

  127. <p>When the user specifies <samp>-ggdb</samp>, GCC normally also uses the

  128. value of this macro to select the debugging output format, but with two

  129. exceptions.  If <code>DWARF2_DEBUGGING_INFO</code> is defined, GCC uses the

  130. value <code>DWARF2_DEBUG</code>.  Otherwise, if <code>DBX_DEBUGGING_INFO</code> is

  131. defined, GCC uses <code>DBX_DEBUG</code>.

  132. </p>

  133. <p>The value of this macro only affects the default debugging output; the

  134. user can always get a specific type of output by using <samp>-gstabs</samp>,

  135. <samp>-gdwarf-2</samp>, <samp>-gxcoff</samp>, or <samp>-gvms</samp>.

  136. </p></dd></dl>

  137. 

  138. <hr>

  139. <div class="header">

  140. <p>

  141. Next: <a href="DBX-Options.html#DBX-Options" accesskey="n" rel="next">DBX Options</a>, Up: <a href="Debugging-Info.html#Debugging-Info" accesskey="u" rel="up">Debugging Info</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>

  142. </div>

  143. 

  144. 

  145. 

  146. </body>

  147. </html>