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
Tree: 898a39b5ab
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '898a39b5ab'
${ noResults }
toolchain-gcc-arm-embedded/share/doc/gcc-arm-none-eabi/html/gdb/Trace-Files.html

143 lines
6.2KB
Raw 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 "Free Software" and "Free Software Needs

  9. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"

  10. and with the Back-Cover Texts as in (a) below.

  11. 

  12. (a) The FSF's Back-Cover Text is: "You are free to copy and modify

  13. this GNU Manual.  Buying copies from GNU Press supports the FSF in

  14. developing GNU and promoting software freedom." -->

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

  16. <head>

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

  18. <title>Trace Files (Debugging with GDB)</title>

  19. 

  20. <meta name="description" content="Trace Files (Debugging with GDB)">

  21. <meta name="keywords" content="Trace Files (Debugging with GDB)">

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

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

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

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

  26. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">

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

  28. <link href="Tracepoints.html#Tracepoints" rel="up" title="Tracepoints">

  29. <link href="Overlays.html#Overlays" rel="next" title="Overlays">

  30. <link href="Tracepoint-Variables.html#Tracepoint-Variables" rel="prev" title="Tracepoint Variables">

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

  32. <!--

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

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

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

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

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

  38. div.example {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.smalllisp {margin-left: 3.2em}

  43. kbd {font-style: oblique}

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

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

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

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

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

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

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

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

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

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

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

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

  56. -->

  57. </style>

  58. 

  59. 

  60. </head>

  61. 

  62. <body lang="en">

  63. <a name="Trace-Files"></a>

  64. <div class="header">

  65. <p>

  66. Previous: <a href="Tracepoint-Variables.html#Tracepoint-Variables" accesskey="p" rel="prev">Tracepoint Variables</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>

  67. </div>

  68. <hr>

  69. <a name="Using-Trace-Files"></a>

  70. <h3 class="section">13.4 Using Trace Files</h3>

  71. <a name="index-trace-files"></a>

  72. 

  73. <p>In some situations, the target running a trace experiment may no

  74. longer be available; perhaps it crashed, or the hardware was needed

  75. for a different activity.  To handle these cases, you can arrange to

  76. dump the trace data into a file, and later use that file as a source

  77. of trace data, via the <code>target tfile</code> command.

  78. </p>

  79. <dl compact="compact">

  80. <dd>

  81. <a name="index-tsave"></a>

  82. </dd>

  83. <dt><code>tsave [ -r ] <var>filename</var></code></dt>

  84. <dt><code>tsave [-ctf] <var>dirname</var></code></dt>

  85. <dd><p>Save the trace data to <var>filename</var>.  By default, this command

  86. assumes that <var>filename</var> refers to the host filesystem, so if

  87. necessary <small>GDB</small> will copy raw trace data up from the target and

  88. then save it.  If the target supports it, you can also supply the

  89. optional argument <code>-r</code> (&ldquo;remote&rdquo;) to direct the target to save

  90. the data directly into <var>filename</var> in its own filesystem, which may be

  91. more efficient if the trace buffer is very large.  (Note, however, that

  92. <code>target tfile</code> can only read from files accessible to the host.)

  93. By default, this command will save trace frame in tfile format.

  94. You can supply the optional argument <code>-ctf</code> to save data in CTF

  95. format.  The <em>Common Trace Format</em> (CTF) is proposed as a trace format

  96. that can be shared by multiple debugging and tracing tools.  Please go to

  97. &lsquo;<code>http://www.efficios.com/ctf</code>&rsquo; to get more information.

  98. </p>

  99. <a name="index-target-tfile"></a>

  100. <a name="index-tfile"></a>

  101. <a name="index-target-ctf"></a>

  102. <a name="index-ctf"></a>

  103. </dd>

  104. <dt><code>target tfile <var>filename</var></code></dt>

  105. <dt><code>target ctf <var>dirname</var></code></dt>

  106. <dd><p>Use the file named <var>filename</var> or directory named <var>dirname</var> as

  107. a source of trace data.  Commands that examine data work as they do with

  108. a live target, but it is not possible to run any new trace experiments.

  109. <code>tstatus</code> will report the state of the trace run at the moment

  110. the data was saved, as well as the current trace frame you are examining.

  111. Both <var>filename</var> and <var>dirname</var> must be on a filesystem accessible to

  112. the host.

  113. </p>

  114. <div class="smallexample">

  115. <pre class="smallexample">(gdb) target ctf ctf.ctf

  116. (gdb) tfind

  117. Found trace frame 0, tracepoint 2

  118. 39            ++a;  /* set tracepoint 1 here */

  119. (gdb) tdump

  120. Data collected at tracepoint 2, trace frame 0:

  121. i = 0

  122. a = 0

  123. b = 1 '\001'

  124. c = {&quot;123&quot;, &quot;456&quot;, &quot;789&quot;, &quot;123&quot;, &quot;456&quot;, &quot;789&quot;}

  125. d = {{{a = 1, b = 2}, {a = 3, b = 4}}, {{a = 5, b = 6}, {a = 7, b = 8}}}

  126. (gdb) p b

  127. $1 = 1

  128. </pre></div>

  129. 

  130. </dd>

  131. </dl>

  132. 

  133. <hr>

  134. <div class="header">

  135. <p>

  136. Previous: <a href="Tracepoint-Variables.html#Tracepoint-Variables" accesskey="p" rel="prev">Tracepoint Variables</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>

  137. </div>

  138. 

  139. 

  140. 

  141. </body>

  142. </html>