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/C_002b_002b-Exception-GDB_0...

230 lines
10.0KB
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>C++ Exception GDB/MI Catchpoint Commands (Debugging with GDB)</title>

  19. 

  20. <meta name="description" content="C++ Exception GDB/MI Catchpoint Commands (Debugging with GDB)">

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

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

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

  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="C_002b_002b-Exception-GDB_002fMI-Catchpoint-Commands"></a>

  64. <div class="header">

  65. <p>

  66. Previous: <a href="Ada-Exception-GDB_002fMI-Catchpoint-Commands.html#Ada-Exception-GDB_002fMI-Catchpoint-Commands" accesskey="p" rel="prev">Ada Exception GDB/MI Catchpoint Commands</a>, Up: <a href="GDB_002fMI-Catchpoint-Commands.html#GDB_002fMI-Catchpoint-Commands" accesskey="u" rel="up">GDB/MI Catchpoint Commands</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="C_002b_002b-Exception-GDB_002fMI-Catchpoints"></a>

  70. <h4 class="subsection">27.9.3 C<tt>++</tt> Exception <small>GDB/MI</small> Catchpoints</h4>

  71. 

  72. <p>The following <small>GDB/MI</small> commands can be used to create catchpoints

  73. that stop the execution when C<tt>++</tt> exceptions are being throw, rethrown,

  74. or caught.

  75. </p>

  76. <a name="The-_002dcatch_002dthrow-Command"></a>

  77. <h4 class="subheading">The <code>-catch-throw</code> Command</h4>

  78. <a name="index-_002dcatch_002dthrow"></a>

  79. 

  80. <a name="Synopsis-18"></a>

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

  82. 

  83. <div class="smallexample">

  84. <pre class="smallexample"> -catch-throw [ -t ] [ -r <var>regexp</var>]

  85. </pre></div>

  86. 

  87. <p>Stop when the debuggee throws a C<tt>++</tt> exception.  If <var>regexp</var> is

  88. given, then only exceptions whose type matches the regular expression

  89. will be caught.

  90. </p>

  91. <p>If &lsquo;<samp>-t</samp>&rsquo; is given, then the catchpoint is enabled only for one

  92. stop, the catchpoint is automatically deleted after stopping once for

  93. the event.

  94. </p>

  95. <a name="GDB-Command-17"></a>

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

  97. 

  98. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>catch throw</samp>&rsquo;

  99. and &lsquo;<samp>tcatch throw</samp>&rsquo; (see <a href="Set-Catchpoints.html#Set-Catchpoints">Set Catchpoints</a>).

  100. </p>

  101. <a name="Example-17"></a>

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

  103. 

  104. <div class="smallexample">

  105. <pre class="smallexample">-catch-throw -r exception_type

  106. ^done,bkpt={number=&quot;1&quot;,type=&quot;catchpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,

  107.   what=&quot;exception throw&quot;,catch-type=&quot;throw&quot;,

  108.   thread-groups=[&quot;i1&quot;],

  109.   regexp=&quot;exception_type&quot;,times=&quot;0&quot;}

  110. (gdb)

  111. -exec-run

  112. ^running

  113. (gdb)

  114. ~&quot;\n&quot;

  115. ~&quot;Catchpoint 1 (exception thrown), 0x00007ffff7ae00ed

  116.   in __cxa_throw () from /lib64/libstdc++.so.6\n&quot;

  117. *stopped,bkptno=&quot;1&quot;,reason=&quot;breakpoint-hit&quot;,disp=&quot;keep&quot;,

  118.   frame={addr=&quot;0x00007ffff7ae00ed&quot;,func=&quot;__cxa_throw&quot;,

  119.   args=[],from=&quot;/lib64/libstdc++.so.6&quot;,arch=&quot;i386:x86-64&quot;},

  120.   thread-id=&quot;1&quot;,stopped-threads=&quot;all&quot;,core=&quot;6&quot;

  121. (gdb)

  122. </pre></div>

  123. 

  124. <a name="The-_002dcatch_002drethrow-Command"></a>

  125. <h4 class="subheading">The <code>-catch-rethrow</code> Command</h4>

  126. <a name="index-_002dcatch_002drethrow"></a>

  127. 

  128. <a name="Synopsis-19"></a>

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

  130. 

  131. <div class="smallexample">

  132. <pre class="smallexample"> -catch-rethrow [ -t ] [ -r <var>regexp</var>]

  133. </pre></div>

  134. 

  135. <p>Stop when a C<tt>++</tt> exception is re-thrown.  If <var>regexp</var> is given,

  136. then only exceptions whose type matches the regular expression will be

  137. caught.

  138. </p>

  139. <p>If &lsquo;<samp>-t</samp>&rsquo; is given, then the catchpoint is enabled only for one

  140. stop, the catchpoint is automatically deleted after the first event is

  141. caught.

  142. </p>

  143. <a name="GDB-Command-18"></a>

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

  145. 

  146. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>catch rethrow</samp>&rsquo;

  147. and &lsquo;<samp>tcatch rethrow</samp>&rsquo; (see <a href="Set-Catchpoints.html#Set-Catchpoints">Set Catchpoints</a>).

  148. </p>

  149. <a name="Example-18"></a>

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

  151. 

  152. <div class="smallexample">

  153. <pre class="smallexample">-catch-rethrow -r exception_type

  154. ^done,bkpt={number=&quot;1&quot;,type=&quot;catchpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,

  155.   what=&quot;exception rethrow&quot;,catch-type=&quot;rethrow&quot;,

  156.   thread-groups=[&quot;i1&quot;],

  157.   regexp=&quot;exception_type&quot;,times=&quot;0&quot;}

  158. (gdb)

  159. -exec-run

  160. ^running

  161. (gdb)

  162. ~&quot;\n&quot;

  163. ~&quot;Catchpoint 1 (exception rethrown), 0x00007ffff7ae00ed

  164.   in __cxa_rethrow () from /lib64/libstdc++.so.6\n&quot;

  165. *stopped,bkptno=&quot;1&quot;,reason=&quot;breakpoint-hit&quot;,disp=&quot;keep&quot;,

  166.   frame={addr=&quot;0x00007ffff7ae00ed&quot;,func=&quot;__cxa_rethrow&quot;,

  167.   args=[],from=&quot;/lib64/libstdc++.so.6&quot;,arch=&quot;i386:x86-64&quot;},

  168.   thread-id=&quot;1&quot;,stopped-threads=&quot;all&quot;,core=&quot;6&quot;

  169. (gdb)

  170. </pre></div>

  171. 

  172. <a name="The-_002dcatch_002dcatch-Command"></a>

  173. <h4 class="subheading">The <code>-catch-catch</code> Command</h4>

  174. <a name="index-_002dcatch_002dcatch"></a>

  175. 

  176. <a name="Synopsis-20"></a>

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

  178. 

  179. <div class="smallexample">

  180. <pre class="smallexample"> -catch-catch [ -t ] [ -r <var>regexp</var>]

  181. </pre></div>

  182. 

  183. <p>Stop when the debuggee catches a C<tt>++</tt> exception.  If <var>regexp</var>

  184. is given, then only exceptions whose type matches the regular

  185. expression will be caught.

  186. </p>

  187. <p>If &lsquo;<samp>-t</samp>&rsquo; is given, then the catchpoint is enabled only for one

  188. stop, the catchpoint is automatically deleted after the first event is

  189. caught.

  190. </p>

  191. <a name="GDB-Command-19"></a>

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

  193. 

  194. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>catch catch</samp>&rsquo;

  195. and &lsquo;<samp>tcatch catch</samp>&rsquo; (see <a href="Set-Catchpoints.html#Set-Catchpoints">Set Catchpoints</a>).

  196. </p>

  197. <a name="Example-19"></a>

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

  199. 

  200. <div class="smallexample">

  201. <pre class="smallexample">-catch-catch -r exception_type

  202. ^done,bkpt={number=&quot;1&quot;,type=&quot;catchpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,

  203.   what=&quot;exception catch&quot;,catch-type=&quot;catch&quot;,

  204.   thread-groups=[&quot;i1&quot;],

  205.   regexp=&quot;exception_type&quot;,times=&quot;0&quot;}

  206. (gdb)

  207. -exec-run

  208. ^running

  209. (gdb)

  210. ~&quot;\n&quot;

  211. ~&quot;Catchpoint 1 (exception caught), 0x00007ffff7ae00ed

  212.   in __cxa_begin_catch () from /lib64/libstdc++.so.6\n&quot;

  213. *stopped,bkptno=&quot;1&quot;,reason=&quot;breakpoint-hit&quot;,disp=&quot;keep&quot;,

  214.   frame={addr=&quot;0x00007ffff7ae00ed&quot;,func=&quot;__cxa_begin_catch&quot;,

  215.   args=[],from=&quot;/lib64/libstdc++.so.6&quot;,arch=&quot;i386:x86-64&quot;},

  216.   thread-id=&quot;1&quot;,stopped-threads=&quot;all&quot;,core=&quot;6&quot;

  217. (gdb)

  218. </pre></div>

  219. 

  220. <hr>

  221. <div class="header">

  222. <p>

  223. Previous: <a href="Ada-Exception-GDB_002fMI-Catchpoint-Commands.html#Ada-Exception-GDB_002fMI-Catchpoint-Commands" accesskey="p" rel="prev">Ada Exception GDB/MI Catchpoint Commands</a>, Up: <a href="GDB_002fMI-Catchpoint-Commands.html#GDB_002fMI-Catchpoint-Commands" accesskey="u" rel="up">GDB/MI Catchpoint Commands</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>

  224. </div>

  225. 

  226. 

  227. 

  228. </body>

  229. </html>