Nie możesz wybrać więcej, niż 25 tematów Tematy muszą się zaczynać od litery lub cyfry, mogą zawierać myślniki ('-') i mogą mieć do 35 znaków.

157 lines
8.7KB

  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. 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 "Free Software" and "Free Software Needs
  8. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
  9. and with the Back-Cover Texts as in (a) below.
  10. (a) The FSF's Back-Cover Text is: "You are free to copy and modify
  11. this GNU Manual. Buying copies from GNU Press supports the FSF in
  12. developing GNU and promoting software freedom." -->
  13. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
  14. <head>
  15. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  16. <title>Set Tracepoints (Debugging with GDB)</title>
  17. <meta name="description" content="Set Tracepoints (Debugging with GDB)">
  18. <meta name="keywords" content="Set Tracepoints (Debugging with GDB)">
  19. <meta name="resource-type" content="document">
  20. <meta name="distribution" content="global">
  21. <meta name="Generator" content="makeinfo">
  22. <link href="index.html#Top" rel="start" title="Top">
  23. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
  24. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  25. <link href="Tracepoints.html#Tracepoints" rel="up" title="Tracepoints">
  26. <link href="Create-and-Delete-Tracepoints.html#Create-and-Delete-Tracepoints" rel="next" title="Create and Delete Tracepoints">
  27. <link href="Tracepoints.html#Tracepoints" rel="prev" title="Tracepoints">
  28. <style type="text/css">
  29. <!--
  30. a.summary-letter {text-decoration: none}
  31. blockquote.indentedblock {margin-right: 0em}
  32. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
  33. blockquote.smallquotation {font-size: smaller}
  34. div.display {margin-left: 3.2em}
  35. div.example {margin-left: 3.2em}
  36. div.lisp {margin-left: 3.2em}
  37. div.smalldisplay {margin-left: 3.2em}
  38. div.smallexample {margin-left: 3.2em}
  39. div.smalllisp {margin-left: 3.2em}
  40. kbd {font-style: oblique}
  41. pre.display {font-family: inherit}
  42. pre.format {font-family: inherit}
  43. pre.menu-comment {font-family: serif}
  44. pre.menu-preformatted {font-family: serif}
  45. pre.smalldisplay {font-family: inherit; font-size: smaller}
  46. pre.smallexample {font-size: smaller}
  47. pre.smallformat {font-family: inherit; font-size: smaller}
  48. pre.smalllisp {font-size: smaller}
  49. span.nolinebreak {white-space: nowrap}
  50. span.roman {font-family: initial; 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">
  57. <a name="Set-Tracepoints"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Analyze-Collected-Data.html#Analyze-Collected-Data" accesskey="n" rel="next">Analyze Collected Data</a>, Up: <a href="Tracepoints.html#Tracepoints" accesskey="u" rel="up">Tracepoints</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Commands-to-Set-Tracepoints"></a>
  64. <h3 class="section">13.1 Commands to Set Tracepoints</h3>
  65. <p>Before running such a <em>trace experiment</em>, an arbitrary number of
  66. tracepoints can be set. A tracepoint is actually a special type of
  67. breakpoint (see <a href="Set-Breaks.html#Set-Breaks">Set Breaks</a>), so you can manipulate it using
  68. standard breakpoint commands. For instance, as with breakpoints,
  69. tracepoint numbers are successive integers starting from one, and many
  70. of the commands associated with tracepoints take the tracepoint number
  71. as their argument, to identify which tracepoint to work on.
  72. </p>
  73. <p>For each tracepoint, you can specify, in advance, some arbitrary set
  74. of data that you want the target to collect in the trace buffer when
  75. it hits that tracepoint. The collected data can include registers,
  76. local variables, or global data. Later, you can use <small>GDB</small>
  77. commands to examine the values these data had at the time the
  78. tracepoint was hit.
  79. </p>
  80. <p>Tracepoints do not support every breakpoint feature. Ignore counts on
  81. tracepoints have no effect, and tracepoints cannot run <small>GDB</small>
  82. commands when they are hit. Tracepoints may not be thread-specific
  83. either.
  84. </p>
  85. <a name="index-fast-tracepoints"></a>
  86. <p>Some targets may support <em>fast tracepoints</em>, which are inserted in
  87. a different way (such as with a jump instead of a trap), that is
  88. faster but possibly restricted in where they may be installed.
  89. </p>
  90. <a name="index-static-tracepoints"></a>
  91. <a name="index-markers_002c-static-tracepoints"></a>
  92. <a name="index-probing-markers_002c-static-tracepoints"></a>
  93. <p>Regular and fast tracepoints are dynamic tracing facilities, meaning
  94. that they can be used to insert tracepoints at (almost) any location
  95. in the target. Some targets may also support controlling <em>static
  96. tracepoints</em> from <small>GDB</small>. With static tracing, a set of
  97. instrumentation points, also known as <em>markers</em>, are embedded in
  98. the target program, and can be activated or deactivated by name or
  99. address. These are usually placed at locations which facilitate
  100. investigating what the target is actually doing. <small>GDB</small>&rsquo;s
  101. support for static tracing includes being able to list instrumentation
  102. points, and attach them with <small>GDB</small> defined high level
  103. tracepoints that expose the whole range of convenience of
  104. <small>GDB</small>&rsquo;s tracepoints support. Namely, support for collecting
  105. registers values and values of global or local (to the instrumentation
  106. point) variables; tracepoint conditions and trace state variables.
  107. The act of installing a <small>GDB</small> static tracepoint on an
  108. instrumentation point, or marker, is referred to as <em>probing</em> a
  109. static tracepoint marker.
  110. </p>
  111. <p><code>gdbserver</code> supports tracepoints on some target systems.
  112. See <a href="Server.html#Server">Tracepoints support in <code>gdbserver</code></a>.
  113. </p>
  114. <p>This section describes commands to set tracepoints and associated
  115. conditions and actions.
  116. </p>
  117. <table class="menu" border="0" cellspacing="0">
  118. <tr><td align="left" valign="top">&bull; <a href="Create-and-Delete-Tracepoints.html#Create-and-Delete-Tracepoints" accesskey="1">Create and Delete Tracepoints</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  119. </td></tr>
  120. <tr><td align="left" valign="top">&bull; <a href="Enable-and-Disable-Tracepoints.html#Enable-and-Disable-Tracepoints" accesskey="2">Enable and Disable Tracepoints</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  121. </td></tr>
  122. <tr><td align="left" valign="top">&bull; <a href="Tracepoint-Passcounts.html#Tracepoint-Passcounts" accesskey="3">Tracepoint Passcounts</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  123. </td></tr>
  124. <tr><td align="left" valign="top">&bull; <a href="Tracepoint-Conditions.html#Tracepoint-Conditions" accesskey="4">Tracepoint Conditions</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  125. </td></tr>
  126. <tr><td align="left" valign="top">&bull; <a href="Trace-State-Variables.html#Trace-State-Variables" accesskey="5">Trace State Variables</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  127. </td></tr>
  128. <tr><td align="left" valign="top">&bull; <a href="Tracepoint-Actions.html#Tracepoint-Actions" accesskey="6">Tracepoint Actions</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  129. </td></tr>
  130. <tr><td align="left" valign="top">&bull; <a href="Listing-Tracepoints.html#Listing-Tracepoints" accesskey="7">Listing Tracepoints</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  131. </td></tr>
  132. <tr><td align="left" valign="top">&bull; <a href="Listing-Static-Tracepoint-Markers.html#Listing-Static-Tracepoint-Markers" accesskey="8">Listing Static Tracepoint Markers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  133. </td></tr>
  134. <tr><td align="left" valign="top">&bull; <a href="Starting-and-Stopping-Trace-Experiments.html#Starting-and-Stopping-Trace-Experiments" accesskey="9">Starting and Stopping Trace Experiments</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  135. </td></tr>
  136. <tr><td align="left" valign="top">&bull; <a href="Tracepoint-Restrictions.html#Tracepoint-Restrictions">Tracepoint Restrictions</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
  137. </td></tr>
  138. </table>
  139. <hr>
  140. <div class="header">
  141. <p>
  142. Next: <a href="Analyze-Collected-Data.html#Analyze-Collected-Data" accesskey="n" rel="next">Analyze Collected Data</a>, Up: <a href="Tracepoints.html#Tracepoints" accesskey="u" rel="up">Tracepoints</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
  143. </div>
  144. </body>
  145. </html>