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-Simple-Examples....

154 lines
6.5KB
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 Simple Examples (Debugging with GDB)</title>

  19. 

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

  21. <meta name="keywords" content="GDB/MI Simple Examples (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-Command-Description-Format.html#GDB_002fMI-Command-Description-Format" rel="next" title="GDB/MI Command Description Format">

  30. <link href="GDB_002fMI-Ada-Exception-Information.html#GDB_002fMI-Ada-Exception-Information" rel="prev" title="GDB/MI Ada Exception Information">

  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-Simple-Examples"></a>

  64. <div class="header">

  65. <p>

  66. Next: <a href="GDB_002fMI-Command-Description-Format.html#GDB_002fMI-Command-Description-Format" accesskey="n" rel="next">GDB/MI Command Description Format</a>, Previous: <a href="GDB_002fMI-Output-Records.html#GDB_002fMI-Output-Records" accesskey="p" rel="prev">GDB/MI Output Records</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="Simple-Examples-of-GDB_002fMI-Interaction"></a>

  70. <h3 class="section">27.6 Simple Examples of <small>GDB/MI</small> Interaction</h3>

  71. <a name="index-GDB_002fMI_002c-simple-examples"></a>

  72. 

  73. <p>This subsection presents several simple examples of interaction using

  74. the <small>GDB/MI</small> interface.  In these examples, &lsquo;<samp>-&gt;</samp>&rsquo; means that the

  75. following line is passed to <small>GDB/MI</small> as input, while &lsquo;<samp>&lt;-</samp>&rsquo; means

  76. the output received from <small>GDB/MI</small>.

  77. </p>

  78. <p>Note the line breaks shown in the examples are here only for

  79. readability, they don&rsquo;t appear in the real output.

  80. </p>

  81. <a name="Setting-a-Breakpoint"></a>

  82. <h4 class="subheading">Setting a Breakpoint</h4>

  83. 

  84. <p>Setting a breakpoint generates synchronous output which contains detailed

  85. information of the breakpoint.

  86. </p>

  87. <div class="smallexample">

  88. <pre class="smallexample">-&gt; -break-insert main

  89. &lt;- ^done,bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,

  90.     enabled=&quot;y&quot;,addr=&quot;0x08048564&quot;,func=&quot;main&quot;,file=&quot;myprog.c&quot;,

  91.     fullname=&quot;/home/nickrob/myprog.c&quot;,line=&quot;68&quot;,thread-groups=[&quot;i1&quot;],

  92.     times=&quot;0&quot;}

  93. &lt;- (gdb)

  94. </pre></div>

  95. 

  96. <a name="Program-Execution"></a>

  97. <h4 class="subheading">Program Execution</h4>

  98. 

  99. <p>Program execution generates asynchronous records and MI gives the

  100. reason that execution stopped.

  101. </p>

  102. <div class="smallexample">

  103. <pre class="smallexample">-&gt; -exec-run

  104. &lt;- ^running

  105. &lt;- (gdb)

  106. &lt;- *stopped,reason=&quot;breakpoint-hit&quot;,disp=&quot;keep&quot;,bkptno=&quot;1&quot;,thread-id=&quot;0&quot;,

  107.    frame={addr=&quot;0x08048564&quot;,func=&quot;main&quot;,

  108.    args=[{name=&quot;argc&quot;,value=&quot;1&quot;},{name=&quot;argv&quot;,value=&quot;0xbfc4d4d4&quot;}],

  109.    file=&quot;myprog.c&quot;,fullname=&quot;/home/nickrob/myprog.c&quot;,line=&quot;68&quot;,

  110.    arch=&quot;i386:x86_64&quot;}

  111. &lt;- (gdb)

  112. -&gt; -exec-continue

  113. &lt;- ^running

  114. &lt;- (gdb)

  115. &lt;- *stopped,reason=&quot;exited-normally&quot;

  116. &lt;- (gdb)

  117. </pre></div>

  118. 

  119. <a name="Quitting-GDB-2"></a>

  120. <h4 class="subheading">Quitting <small>GDB</small></h4>

  121. 

  122. <p>Quitting <small>GDB</small> just prints the result class &lsquo;<samp>^exit</samp>&rsquo;.

  123. </p>

  124. <div class="smallexample">

  125. <pre class="smallexample">-&gt; (gdb)

  126. &lt;- -gdb-exit

  127. &lt;- ^exit

  128. </pre></div>

  129. 

  130. <p>Please note that &lsquo;<samp>^exit</samp>&rsquo; is printed immediately, but it might

  131. take some time for <small>GDB</small> to actually exit.  During that time, <small>GDB</small>

  132. performs necessary cleanups, including killing programs being debugged

  133. or disconnecting from debug hardware, so the frontend should wait till

  134. <small>GDB</small> exits and should only forcibly kill <small>GDB</small> if it

  135. fails to exit in reasonable time.

  136. </p>

  137. <a name="A-Bad-Command"></a>

  138. <h4 class="subheading">A Bad Command</h4>

  139. 

  140. <p>Here&rsquo;s what happens if you pass a non-existent command:

  141. </p>

  142. <div class="smallexample">

  143. <pre class="smallexample">-&gt; -rubbish

  144. &lt;- ^error,msg=&quot;Undefined MI command: rubbish&quot;

  145. &lt;- (gdb)

  146. </pre></div>

  147. 

  148. 

  149. 

  150. 

  151. 

  152. </body>

  153. </html>