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/GDB_002fMI-Output-Syntax.html

237 lines
10KB
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>GDB/MI Output Syntax (Debugging with GDB)</title>

  19. 

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

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

  29. <link href="GDB_002fMI-Compatibility-with-CLI.html#GDB_002fMI-Compatibility-with-CLI" rel="next" title="GDB/MI Compatibility with CLI">

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

  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-Output-Syntax"></a>

  64. <div class="header">

  65. <p>

  66. Previous: <a href="GDB_002fMI-Input-Syntax.html#GDB_002fMI-Input-Syntax" accesskey="p" rel="prev">GDB/MI Input Syntax</a>, Up: <a href="GDB_002fMI-Command-Syntax.html#GDB_002fMI-Command-Syntax" accesskey="u" rel="up">GDB/MI Command Syntax</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-Output-Syntax-1"></a>

  70. <h4 class="subsection">27.2.2 <small>GDB/MI</small> Output Syntax</h4>

  71. 

  72. <a name="index-output-syntax-of-GDB_002fMI"></a>

  73. <a name="index-GDB_002fMI_002c-output-syntax"></a>

  74. <p>The output from <small>GDB/MI</small> consists of zero or more out-of-band records

  75. followed, optionally, by a single result record.  This result record

  76. is for the most recent command.  The sequence of output records is

  77. terminated by &lsquo;<samp>(gdb)</samp>&rsquo;.

  78. </p>

  79. <p>If an input command was prefixed with a <code><var>token</var></code> then the

  80. corresponding output for that command will also be prefixed by that same

  81. <var>token</var>.

  82. </p>

  83. <dl compact="compact">

  84. <dt><code><var>output</var> &rarr;</code></dt>

  85. <dd><p><code>( <var>out-of-band-record</var> )* [ <var>result-record</var> ] &quot;(gdb)&quot; <var>nl</var></code>

  86. </p>

  87. </dd>

  88. <dt><code><var>result-record</var> &rarr;</code></dt>

  89. <dd><p><code> [ <var>token</var> ] &quot;^&quot; <var>result-class</var> ( &quot;,&quot; <var>result</var> )* <var>nl</var></code>

  90. </p>

  91. </dd>

  92. <dt><code><var>out-of-band-record</var> &rarr;</code></dt>

  93. <dd><p><code><var>async-record</var> | <var>stream-record</var></code>

  94. </p>

  95. </dd>

  96. <dt><code><var>async-record</var> &rarr;</code></dt>

  97. <dd><p><code><var>exec-async-output</var> | <var>status-async-output</var> | <var>notify-async-output</var></code>

  98. </p>

  99. </dd>

  100. <dt><code><var>exec-async-output</var> &rarr;</code></dt>

  101. <dd><p><code>[ <var>token</var> ] &quot;*&quot; <var>async-output nl</var></code>

  102. </p>

  103. </dd>

  104. <dt><code><var>status-async-output</var> &rarr;</code></dt>

  105. <dd><p><code>[ <var>token</var> ] &quot;+&quot; <var>async-output nl</var></code>

  106. </p>

  107. </dd>

  108. <dt><code><var>notify-async-output</var> &rarr;</code></dt>

  109. <dd><p><code>[ <var>token</var> ] &quot;=&quot; <var>async-output nl</var></code>

  110. </p>

  111. </dd>

  112. <dt><code><var>async-output</var> &rarr;</code></dt>

  113. <dd><p><code><var>async-class</var> ( &quot;,&quot; <var>result</var> )*</code>

  114. </p>

  115. </dd>

  116. <dt><code><var>result-class</var> &rarr;</code></dt>

  117. <dd><p><code>&quot;done&quot; | &quot;running&quot; | &quot;connected&quot; | &quot;error&quot; | &quot;exit&quot;</code>

  118. </p>

  119. </dd>

  120. <dt><code><var>async-class</var> &rarr;</code></dt>

  121. <dd><p><code>&quot;stopped&quot; | <var>others</var></code> (where <var>others</var> will be added

  122. depending on the needs&mdash;this is still in development).

  123. </p>

  124. </dd>

  125. <dt><code><var>result</var> &rarr;</code></dt>

  126. <dd><p><code> <var>variable</var> &quot;=&quot; <var>value</var></code>

  127. </p>

  128. </dd>

  129. <dt><code><var>variable</var> &rarr;</code></dt>

  130. <dd><p><code> <var>string</var> </code>

  131. </p>

  132. </dd>

  133. <dt><code><var>value</var> &rarr;</code></dt>

  134. <dd><p><code> <var>const</var> | <var>tuple</var> | <var>list</var> </code>

  135. </p>

  136. </dd>

  137. <dt><code><var>const</var> &rarr;</code></dt>

  138. <dd><p><code><var>c-string</var></code>

  139. </p>

  140. </dd>

  141. <dt><code><var>tuple</var> &rarr;</code></dt>

  142. <dd><p><code> &quot;{}&quot; | &quot;{&quot; <var>result</var> ( &quot;,&quot; <var>result</var> )* &quot;}&quot; </code>

  143. </p>

  144. </dd>

  145. <dt><code><var>list</var> &rarr;</code></dt>

  146. <dd><p><code> &quot;[]&quot; | &quot;[&quot; <var>value</var> ( &quot;,&quot; <var>value</var> )* &quot;]&quot; | &quot;[&quot;

  147. <var>result</var> ( &quot;,&quot; <var>result</var> )* &quot;]&quot; </code>

  148. </p>

  149. </dd>

  150. <dt><code><var>stream-record</var> &rarr;</code></dt>

  151. <dd><p><code><var>console-stream-output</var> | <var>target-stream-output</var> | <var>log-stream-output</var></code>

  152. </p>

  153. </dd>

  154. <dt><code><var>console-stream-output</var> &rarr;</code></dt>

  155. <dd><p><code>&quot;~&quot; <var>c-string nl</var></code>

  156. </p>

  157. </dd>

  158. <dt><code><var>target-stream-output</var> &rarr;</code></dt>

  159. <dd><p><code>&quot;@&quot; <var>c-string nl</var></code>

  160. </p>

  161. </dd>

  162. <dt><code><var>log-stream-output</var> &rarr;</code></dt>

  163. <dd><p><code>&quot;&amp;&quot; <var>c-string nl</var></code>

  164. </p>

  165. </dd>

  166. <dt><code><var>nl</var> &rarr;</code></dt>

  167. <dd><p><code>CR | CR-LF</code>

  168. </p>

  169. </dd>

  170. <dt><code><var>token</var> &rarr;</code></dt>

  171. <dd><p><em>any sequence of digits</em>.

  172. </p></dd>

  173. </dl>

  174. 

  175. <p>Notes:

  176. </p>

  177. <ul>

  178. <li> All output sequences end in a single line containing a period.

  179. 

  180. </li><li> The <code><var>token</var></code> is from the corresponding request.  Note that

  181. for all async output, while the token is allowed by the grammar and

  182. may be output by future versions of <small>GDB</small> for select async

  183. output messages, it is generally omitted.  Frontends should treat

  184. all async output as reporting general changes in the state of the

  185. target and there should be no need to associate async output to any

  186. prior command.

  187. 

  188. </li><li> <a name="index-status-output-in-GDB_002fMI"></a>

  189. <var>status-async-output</var> contains on-going status information about the

  190. progress of a slow operation.  It can be discarded.  All status output is

  191. prefixed by &lsquo;<samp>+</samp>&rsquo;.

  192. 

  193. </li><li> <a name="index-async-output-in-GDB_002fMI"></a>

  194. <var>exec-async-output</var> contains asynchronous state change on the target

  195. (stopped, started, disappeared).  All async output is prefixed by

  196. &lsquo;<samp>*</samp>&rsquo;.

  197. 

  198. </li><li> <a name="index-notify-output-in-GDB_002fMI"></a>

  199. <var>notify-async-output</var> contains supplementary information that the

  200. client should handle (e.g., a new breakpoint information).  All notify

  201. output is prefixed by &lsquo;<samp>=</samp>&rsquo;.

  202. 

  203. </li><li> <a name="index-console-output-in-GDB_002fMI"></a>

  204. <var>console-stream-output</var> is output that should be displayed as is in the

  205. console.  It is the textual response to a CLI command.  All the console

  206. output is prefixed by &lsquo;<samp>~</samp>&rsquo;.

  207. 

  208. </li><li> <a name="index-target-output-in-GDB_002fMI"></a>

  209. <var>target-stream-output</var> is the output produced by the target program.

  210. All the target output is prefixed by &lsquo;<samp>@</samp>&rsquo;.

  211. 

  212. </li><li> <a name="index-log-output-in-GDB_002fMI"></a>

  213. <var>log-stream-output</var> is output text coming from <small>GDB</small>&rsquo;s internals, for

  214. instance messages that should be displayed as part of an error log.  All

  215. the log output is prefixed by &lsquo;<samp>&amp;</samp>&rsquo;.

  216. 

  217. </li><li> <a name="index-list-output-in-GDB_002fMI"></a>

  218. New <small>GDB/MI</small> commands should only output <var>lists</var> containing

  219. <var>values</var>.

  220. 

  221. 

  222. </li></ul>

  223. 

  224. <p>See <a href="GDB_002fMI-Stream-Records.html#GDB_002fMI-Stream-Records"><small>GDB/MI</small> Stream Records</a>, for more

  225. details about the various output records.

  226. </p>

  227. <hr>

  228. <div class="header">

  229. <p>

  230. Previous: <a href="GDB_002fMI-Input-Syntax.html#GDB_002fMI-Input-Syntax" accesskey="p" rel="prev">GDB/MI Input Syntax</a>, Up: <a href="GDB_002fMI-Command-Syntax.html#GDB_002fMI-Command-Syntax" accesskey="u" rel="up">GDB/MI Command Syntax</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>

  231. </div>

  232. 

  233. 

  234. 

  235. </body>

  236. </html>