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/gdb/GDB_002fMI-Tracepoint-Comma...

527 lines
21KB
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 "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>GDB/MI Tracepoint Commands (Debugging with GDB)</title>

  19. 

  20. <meta name="description" content="GDB/MI Tracepoint Commands (Debugging with GDB)">

  21. <meta name="keywords" content="GDB/MI Tracepoint Commands (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="GDB_002fMI.html#GDB_002fMI" rel="up" title="GDB/MI">

  29. <link href="GDB_002fMI-Symbol-Query.html#GDB_002fMI-Symbol-Query" rel="next" title="GDB/MI Symbol Query">

  30. <link href="GDB_002fMI-Data-Manipulation.html#GDB_002fMI-Data-Manipulation" rel="prev" title="GDB/MI Data Manipulation">

  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="GDB_002fMI-Tracepoint-Commands"></a>

  64. <div class="header">

  65. <p>

  66. Next: <a href="GDB_002fMI-Symbol-Query.html#GDB_002fMI-Symbol-Query" accesskey="n" rel="next">GDB/MI Symbol Query</a>, Previous: <a href="GDB_002fMI-Data-Manipulation.html#GDB_002fMI-Data-Manipulation" accesskey="p" rel="prev">GDB/MI Data Manipulation</a>, Up: <a href="GDB_002fMI.html#GDB_002fMI" accesskey="u" rel="up">GDB/MI</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="GDB_002fMI-Tracepoint-Commands-1"></a>

  70. <h3 class="section">27.17 <small>GDB/MI</small> Tracepoint Commands</h3>

  71. 

  72. <p>The commands defined in this section implement MI support for

  73. tracepoints.  For detailed introduction, see <a href="Tracepoints.html#Tracepoints">Tracepoints</a>.

  74. </p>

  75. <a name="The-_002dtrace_002dfind-Command"></a>

  76. <h4 class="subheading">The <code>-trace-find</code> Command</h4>

  77. <a name="index-_002dtrace_002dfind"></a>

  78. 

  79. <a name="Synopsis-72"></a>

  80. <h4 class="subsubheading">Synopsis</h4>

  81. 

  82. <div class="smallexample">

  83. <pre class="smallexample"> -trace-find <var>mode</var> [<var>parameters</var>&hellip;]

  84. </pre></div>

  85. 

  86. <p>Find a trace frame using criteria defined by <var>mode</var> and

  87. <var>parameters</var>.  The following table lists permissible

  88. modes and their parameters.  For details of operation, see <a href="tfind.html#tfind">tfind</a>.

  89. </p>

  90. <dl compact="compact">

  91. <dt>&lsquo;<samp>none</samp>&rsquo;</dt>

  92. <dd><p>No parameters are required.  Stops examining trace frames.

  93. </p>

  94. </dd>

  95. <dt>&lsquo;<samp>frame-number</samp>&rsquo;</dt>

  96. <dd><p>An integer is required as parameter.  Selects tracepoint frame with

  97. that index.

  98. </p>

  99. </dd>

  100. <dt>&lsquo;<samp>tracepoint-number</samp>&rsquo;</dt>

  101. <dd><p>An integer is required as parameter.  Finds next

  102. trace frame that corresponds to tracepoint with the specified number.

  103. </p>

  104. </dd>

  105. <dt>&lsquo;<samp>pc</samp>&rsquo;</dt>

  106. <dd><p>An address is required as parameter.  Finds

  107. next trace frame that corresponds to any tracepoint at the specified

  108. address.

  109. </p>

  110. </dd>

  111. <dt>&lsquo;<samp>pc-inside-range</samp>&rsquo;</dt>

  112. <dd><p>Two addresses are required as parameters.  Finds next trace

  113. frame that corresponds to a tracepoint at an address inside the

  114. specified range.  Both bounds are considered to be inside the range.

  115. </p>

  116. </dd>

  117. <dt>&lsquo;<samp>pc-outside-range</samp>&rsquo;</dt>

  118. <dd><p>Two addresses are required as parameters.  Finds

  119. next trace frame that corresponds to a tracepoint at an address outside

  120. the specified range.  Both bounds are considered to be inside the range.

  121. </p>

  122. </dd>

  123. <dt>&lsquo;<samp>line</samp>&rsquo;</dt>

  124. <dd><p>Line specification is required as parameter.  See <a href="Specify-Location.html#Specify-Location">Specify Location</a>.

  125. Finds next trace frame that corresponds to a tracepoint at

  126. the specified location.

  127. </p>

  128. </dd>

  129. </dl>

  130. 

  131. <p>If &lsquo;<samp>none</samp>&rsquo; was passed as <var>mode</var>, the response does not

  132. have fields.  Otherwise, the response may have the following fields:

  133. </p>

  134. <dl compact="compact">

  135. <dt>&lsquo;<samp>found</samp>&rsquo;</dt>

  136. <dd><p>This field has either &lsquo;<samp>0</samp>&rsquo; or &lsquo;<samp>1</samp>&rsquo; as the value, depending

  137. on whether a matching tracepoint was found.

  138. </p>

  139. </dd>

  140. <dt>&lsquo;<samp>traceframe</samp>&rsquo;</dt>

  141. <dd><p>The index of the found traceframe.  This field is present iff

  142. the &lsquo;<samp>found</samp>&rsquo; field has value of &lsquo;<samp>1</samp>&rsquo;.

  143. </p>

  144. </dd>

  145. <dt>&lsquo;<samp>tracepoint</samp>&rsquo;</dt>

  146. <dd><p>The index of the found tracepoint.  This field is present iff

  147. the &lsquo;<samp>found</samp>&rsquo; field has value of &lsquo;<samp>1</samp>&rsquo;.

  148. </p>

  149. </dd>

  150. <dt>&lsquo;<samp>frame</samp>&rsquo;</dt>

  151. <dd><p>The information about the frame corresponding to the found trace

  152. frame.  This field is present only if a trace frame was found.

  153. See <a href="GDB_002fMI-Frame-Information.html#GDB_002fMI-Frame-Information">GDB/MI Frame Information</a>, for description of this field.

  154. </p>

  155. </dd>

  156. </dl>

  157. 

  158. <a name="GDB-Command-54"></a>

  159. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  160. 

  161. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tfind</samp>&rsquo;.

  162. </p>

  163. <a name="g_t_002dtrace_002ddefine_002dvariable"></a>

  164. <h4 class="subheading">-trace-define-variable</h4>

  165. <a name="index-_002dtrace_002ddefine_002dvariable"></a>

  166. 

  167. <a name="Synopsis-73"></a>

  168. <h4 class="subsubheading">Synopsis</h4>

  169. 

  170. <div class="smallexample">

  171. <pre class="smallexample"> -trace-define-variable <var>name</var> [ <var>value</var> ]

  172. </pre></div>

  173. 

  174. <p>Create trace variable <var>name</var> if it does not exist.  If

  175. <var>value</var> is specified, sets the initial value of the specified

  176. trace variable to that value.  Note that the <var>name</var> should start

  177. with the &lsquo;<samp>$</samp>&rsquo; character.

  178. </p>

  179. <a name="GDB-Command-55"></a>

  180. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  181. 

  182. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tvariable</samp>&rsquo;.

  183. </p>

  184. <a name="The-_002dtrace_002dframe_002dcollected-Command"></a>

  185. <h4 class="subheading">The <code>-trace-frame-collected</code> Command</h4>

  186. <a name="index-_002dtrace_002dframe_002dcollected"></a>

  187. 

  188. <a name="Synopsis-74"></a>

  189. <h4 class="subsubheading">Synopsis</h4>

  190. 

  191. <div class="smallexample">

  192. <pre class="smallexample"> -trace-frame-collected

  193.     [--var-print-values <var>var_pval</var>]

  194.     [--comp-print-values <var>comp_pval</var>]

  195.     [--registers-format <var>regformat</var>]

  196.     [--memory-contents]

  197. </pre></div>

  198. 

  199. <p>This command returns the set of collected objects, register names,

  200. trace state variable names, memory ranges and computed expressions

  201. that have been collected at a particular trace frame.  The optional

  202. parameters to the command affect the output format in different ways.

  203. See the output description table below for more details.

  204. </p>

  205. <p>The reported names can be used in the normal manner to create

  206. varobjs and inspect the objects themselves.  The items returned by

  207. this command are categorized so that it is clear which is a variable,

  208. which is a register, which is a trace state variable, which is a

  209. memory range and which is a computed expression.

  210. </p>

  211. <p>For instance, if the actions were

  212. </p><div class="smallexample">

  213. <pre class="smallexample">collect myVar, myArray[myIndex], myObj.field, myPtr-&gt;field, myCount + 2

  214. collect *(int*)0xaf02bef0@40

  215. </pre></div>

  216. 

  217. <p>the object collected in its entirety would be <code>myVar</code>.  The

  218. object <code>myArray</code> would be partially collected, because only the

  219. element at index <code>myIndex</code> would be collected.  The remaining

  220. objects would be computed expressions.

  221. </p>

  222. <p>An example output would be:

  223. </p>

  224. <div class="smallexample">

  225. <pre class="smallexample">(gdb)

  226. -trace-frame-collected

  227. ^done,

  228.   explicit-variables=[{name=&quot;myVar&quot;,value=&quot;1&quot;}],

  229.   computed-expressions=[{name=&quot;myArray[myIndex]&quot;,value=&quot;0&quot;},

  230.                         {name=&quot;myObj.field&quot;,value=&quot;0&quot;},

  231.                         {name=&quot;myPtr-&gt;field&quot;,value=&quot;1&quot;},

  232.                         {name=&quot;myCount + 2&quot;,value=&quot;3&quot;},

  233.                         {name=&quot;$tvar1 + 1&quot;,value=&quot;43970027&quot;}],

  234.   registers=[{number=&quot;0&quot;,value=&quot;0x7fe2c6e79ec8&quot;},

  235.              {number=&quot;1&quot;,value=&quot;0x0&quot;},

  236.              {number=&quot;2&quot;,value=&quot;0x4&quot;},

  237.              ...

  238.              {number=&quot;125&quot;,value=&quot;0x0&quot;}],

  239.   tvars=[{name=&quot;$tvar1&quot;,current=&quot;43970026&quot;}],

  240.   memory=[{address=&quot;0x0000000000602264&quot;,length=&quot;4&quot;},

  241.           {address=&quot;0x0000000000615bc0&quot;,length=&quot;4&quot;}]

  242. (gdb)

  243. </pre></div>

  244. 

  245. <p>Where:

  246. </p>

  247. <dl compact="compact">

  248. <dt><code>explicit-variables</code></dt>

  249. <dd><p>The set of objects that have been collected in their entirety (as

  250. opposed to collecting just a few elements of an array or a few struct

  251. members).  For each object, its name and value are printed.

  252. The <code>--var-print-values</code> option affects how or whether the value

  253. field is output.  If <var>var_pval</var> is 0, then print only the names;

  254. if it is 1, print also their values; and if it is 2, print the name,

  255. type and value for simple data types, and the name and type for

  256. arrays, structures and unions.

  257. </p>

  258. </dd>

  259. <dt><code>computed-expressions</code></dt>

  260. <dd><p>The set of computed expressions that have been collected at the

  261. current trace frame.  The <code>--comp-print-values</code> option affects

  262. this set like the <code>--var-print-values</code> option affects the

  263. <code>explicit-variables</code> set.  See above.

  264. </p>

  265. </dd>

  266. <dt><code>registers</code></dt>

  267. <dd><p>The registers that have been collected at the current trace frame.

  268. For each register collected, the name and current value are returned.

  269. The value is formatted according to the <code>--registers-format</code>

  270. option.  See the <code>-data-list-register-values</code> command for a

  271. list of the allowed formats.  The default is &lsquo;<samp>x</samp>&rsquo;.

  272. </p>

  273. </dd>

  274. <dt><code>tvars</code></dt>

  275. <dd><p>The trace state variables that have been collected at the current

  276. trace frame.  For each trace state variable collected, the name and

  277. current value are returned.

  278. </p>

  279. </dd>

  280. <dt><code>memory</code></dt>

  281. <dd><p>The set of memory ranges that have been collected at the current trace

  282. frame.  Its content is a list of tuples.  Each tuple represents a

  283. collected memory range and has the following fields:

  284. </p>

  285. <dl compact="compact">

  286. <dt><code>address</code></dt>

  287. <dd><p>The start address of the memory range, as hexadecimal literal.

  288. </p>

  289. </dd>

  290. <dt><code>length</code></dt>

  291. <dd><p>The length of the memory range, as decimal literal.

  292. </p>

  293. </dd>

  294. <dt><code>contents</code></dt>

  295. <dd><p>The contents of the memory block, in hex.  This field is only present

  296. if the <code>--memory-contents</code> option is specified.

  297. </p>

  298. </dd>

  299. </dl>

  300. 

  301. </dd>

  302. </dl>

  303. 

  304. <a name="GDB-Command-56"></a>

  305. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  306. 

  307. <p>There is no corresponding <small>GDB</small> command.

  308. </p>

  309. <a name="Example-60"></a>

  310. <h4 class="subsubheading">Example</h4>

  311. 

  312. <a name="g_t_002dtrace_002dlist_002dvariables"></a>

  313. <h4 class="subheading">-trace-list-variables</h4>

  314. <a name="index-_002dtrace_002dlist_002dvariables"></a>

  315. 

  316. <a name="Synopsis-75"></a>

  317. <h4 class="subsubheading">Synopsis</h4>

  318. 

  319. <div class="smallexample">

  320. <pre class="smallexample"> -trace-list-variables

  321. </pre></div>

  322. 

  323. <p>Return a table of all defined trace variables.  Each element of the

  324. table has the following fields:

  325. </p>

  326. <dl compact="compact">

  327. <dt>&lsquo;<samp>name</samp>&rsquo;</dt>

  328. <dd><p>The name of the trace variable.  This field is always present.

  329. </p>

  330. </dd>

  331. <dt>&lsquo;<samp>initial</samp>&rsquo;</dt>

  332. <dd><p>The initial value.  This is a 64-bit signed integer.  This

  333. field is always present.

  334. </p>

  335. </dd>

  336. <dt>&lsquo;<samp>current</samp>&rsquo;</dt>

  337. <dd><p>The value the trace variable has at the moment.  This is a 64-bit

  338. signed integer.  This field is absent iff current value is

  339. not defined, for example if the trace was never run, or is

  340. presently running.

  341. </p>

  342. </dd>

  343. </dl>

  344. 

  345. <a name="GDB-Command-57"></a>

  346. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  347. 

  348. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tvariables</samp>&rsquo;.

  349. </p>

  350. <a name="Example-61"></a>

  351. <h4 class="subsubheading">Example</h4>

  352. 

  353. <div class="smallexample">

  354. <pre class="smallexample">(gdb)

  355. -trace-list-variables

  356. ^done,trace-variables={nr_rows=&quot;1&quot;,nr_cols=&quot;3&quot;,

  357. hdr=[{width=&quot;15&quot;,alignment=&quot;-1&quot;,col_name=&quot;name&quot;,colhdr=&quot;Name&quot;},

  358.      {width=&quot;11&quot;,alignment=&quot;-1&quot;,col_name=&quot;initial&quot;,colhdr=&quot;Initial&quot;},

  359.      {width=&quot;11&quot;,alignment=&quot;-1&quot;,col_name=&quot;current&quot;,colhdr=&quot;Current&quot;}],

  360. body=[variable={name=&quot;$trace_timestamp&quot;,initial=&quot;0&quot;}

  361.       variable={name=&quot;$foo&quot;,initial=&quot;10&quot;,current=&quot;15&quot;}]}

  362. (gdb)

  363. </pre></div>

  364. 

  365. <a name="g_t_002dtrace_002dsave"></a>

  366. <h4 class="subheading">-trace-save</h4>

  367. <a name="index-_002dtrace_002dsave"></a>

  368. 

  369. <a name="Synopsis-76"></a>

  370. <h4 class="subsubheading">Synopsis</h4>

  371. 

  372. <div class="smallexample">

  373. <pre class="smallexample"> -trace-save [ -r ] [ -ctf ] <var>filename</var>

  374. </pre></div>

  375. 

  376. <p>Saves the collected trace data to <var>filename</var>.  Without the

  377. &lsquo;<samp>-r</samp>&rsquo; option, the data is downloaded from the target and saved

  378. in a local file.  With the &lsquo;<samp>-r</samp>&rsquo; option the target is asked

  379. to perform the save.

  380. </p>

  381. <p>By default, this command will save the trace in the tfile format.  You can

  382. supply the optional &lsquo;<samp>-ctf</samp>&rsquo; argument to save it the CTF format. See

  383. <a href="Trace-Files.html#Trace-Files">Trace Files</a> for more information about CTF.

  384. </p>

  385. <a name="GDB-Command-58"></a>

  386. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  387. 

  388. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tsave</samp>&rsquo;.

  389. </p>

  390. 

  391. <a name="g_t_002dtrace_002dstart"></a>

  392. <h4 class="subheading">-trace-start</h4>

  393. <a name="index-_002dtrace_002dstart"></a>

  394. 

  395. <a name="Synopsis-77"></a>

  396. <h4 class="subsubheading">Synopsis</h4>

  397. 

  398. <div class="smallexample">

  399. <pre class="smallexample"> -trace-start

  400. </pre></div>

  401. 

  402. <p>Starts a tracing experiment.  The result of this command does not

  403. have any fields.

  404. </p>

  405. <a name="GDB-Command-59"></a>

  406. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  407. 

  408. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tstart</samp>&rsquo;.

  409. </p>

  410. <a name="g_t_002dtrace_002dstatus"></a>

  411. <h4 class="subheading">-trace-status</h4>

  412. <a name="index-_002dtrace_002dstatus"></a>

  413. 

  414. <a name="Synopsis-78"></a>

  415. <h4 class="subsubheading">Synopsis</h4>

  416. 

  417. <div class="smallexample">

  418. <pre class="smallexample"> -trace-status

  419. </pre></div>

  420. 

  421. <p>Obtains the status of a tracing experiment.  The result may include

  422. the following fields:

  423. </p>

  424. <dl compact="compact">

  425. <dt>&lsquo;<samp>supported</samp>&rsquo;</dt>

  426. <dd><p>May have a value of either &lsquo;<samp>0</samp>&rsquo;, when no tracing operations are

  427. supported, &lsquo;<samp>1</samp>&rsquo;, when all tracing operations are supported, or

  428. &lsquo;<samp>file</samp>&rsquo; when examining trace file.  In the latter case, examining

  429. of trace frame is possible but new tracing experiement cannot be

  430. started.  This field is always present.

  431. </p>

  432. </dd>

  433. <dt>&lsquo;<samp>running</samp>&rsquo;</dt>

  434. <dd><p>May have a value of either &lsquo;<samp>0</samp>&rsquo; or &lsquo;<samp>1</samp>&rsquo; depending on whether

  435. tracing experiement is in progress on target.  This field is present

  436. if &lsquo;<samp>supported</samp>&rsquo; field is not &lsquo;<samp>0</samp>&rsquo;.

  437. </p>

  438. </dd>

  439. <dt>&lsquo;<samp>stop-reason</samp>&rsquo;</dt>

  440. <dd><p>Report the reason why the tracing was stopped last time.  This field

  441. may be absent iff tracing was never stopped on target yet.  The

  442. value of &lsquo;<samp>request</samp>&rsquo; means the tracing was stopped as result of

  443. the <code>-trace-stop</code> command.  The value of &lsquo;<samp>overflow</samp>&rsquo; means

  444. the tracing buffer is full.  The value of &lsquo;<samp>disconnection</samp>&rsquo; means

  445. tracing was automatically stopped when <small>GDB</small> has disconnected.

  446. The value of &lsquo;<samp>passcount</samp>&rsquo; means tracing was stopped when a

  447. tracepoint was passed a maximal number of times for that tracepoint.

  448. This field is present if &lsquo;<samp>supported</samp>&rsquo; field is not &lsquo;<samp>0</samp>&rsquo;.

  449. </p>

  450. </dd>

  451. <dt>&lsquo;<samp>stopping-tracepoint</samp>&rsquo;</dt>

  452. <dd><p>The number of tracepoint whose passcount as exceeded.  This field is

  453. present iff the &lsquo;<samp>stop-reason</samp>&rsquo; field has the value of

  454. &lsquo;<samp>passcount</samp>&rsquo;.

  455. </p>

  456. </dd>

  457. <dt>&lsquo;<samp>frames</samp>&rsquo;</dt>

  458. <dt>&lsquo;<samp>frames-created</samp>&rsquo;</dt>

  459. <dd><p>The &lsquo;<samp>frames</samp>&rsquo; field is a count of the total number of trace frames

  460. in the trace buffer, while &lsquo;<samp>frames-created</samp>&rsquo; is the total created

  461. during the run, including ones that were discarded, such as when a

  462. circular trace buffer filled up.  Both fields are optional.

  463. </p>

  464. </dd>

  465. <dt>&lsquo;<samp>buffer-size</samp>&rsquo;</dt>

  466. <dt>&lsquo;<samp>buffer-free</samp>&rsquo;</dt>

  467. <dd><p>These fields tell the current size of the tracing buffer and the

  468. remaining space.  These fields are optional.

  469. </p>

  470. </dd>

  471. <dt>&lsquo;<samp>circular</samp>&rsquo;</dt>

  472. <dd><p>The value of the circular trace buffer flag.  <code>1</code> means that the

  473. trace buffer is circular and old trace frames will be discarded if

  474. necessary to make room, <code>0</code> means that the trace buffer is linear

  475. and may fill up.

  476. </p>

  477. </dd>

  478. <dt>&lsquo;<samp>disconnected</samp>&rsquo;</dt>

  479. <dd><p>The value of the disconnected tracing flag.  <code>1</code> means that

  480. tracing will continue after <small>GDB</small> disconnects, <code>0</code> means

  481. that the trace run will stop.

  482. </p>

  483. </dd>

  484. <dt>&lsquo;<samp>trace-file</samp>&rsquo;</dt>

  485. <dd><p>The filename of the trace file being examined.  This field is

  486. optional, and only present when examining a trace file.

  487. </p>

  488. </dd>

  489. </dl>

  490. 

  491. <a name="GDB-Command-60"></a>

  492. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  493. 

  494. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tstatus</samp>&rsquo;.

  495. </p>

  496. <a name="g_t_002dtrace_002dstop"></a>

  497. <h4 class="subheading">-trace-stop</h4>

  498. <a name="index-_002dtrace_002dstop"></a>

  499. 

  500. <a name="Synopsis-79"></a>

  501. <h4 class="subsubheading">Synopsis</h4>

  502. 

  503. <div class="smallexample">

  504. <pre class="smallexample"> -trace-stop

  505. </pre></div>

  506. 

  507. <p>Stops a tracing experiment.  The result of this command has the same

  508. fields as <code>-trace-status</code>, except that the &lsquo;<samp>supported</samp>&rsquo; and

  509. &lsquo;<samp>running</samp>&rsquo; fields are not output.

  510. </p>

  511. <a name="GDB-Command-61"></a>

  512. <h4 class="subsubheading"><small>GDB</small> Command</h4>

  513. 

  514. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>tstop</samp>&rsquo;.

  515. </p>

  516. 

  517. <hr>

  518. <div class="header">

  519. <p>

  520. Next: <a href="GDB_002fMI-Symbol-Query.html#GDB_002fMI-Symbol-Query" accesskey="n" rel="next">GDB/MI Symbol Query</a>, Previous: <a href="GDB_002fMI-Data-Manipulation.html#GDB_002fMI-Data-Manipulation" accesskey="p" rel="prev">GDB/MI Data Manipulation</a>, Up: <a href="GDB_002fMI.html#GDB_002fMI" accesskey="u" rel="up">GDB/MI</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>

  521. </div>

  522. 

  523. 

  524. 

  525. </body>

  526. </html>