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/Ada-Exception-GDB_002fMI-Ca...

239 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>Ada Exception GDB/MI Catchpoint Commands (Debugging with GDB)</title>

  19. 

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

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

  30. <link href="Shared-Library-GDB_002fMI-Catchpoint-Commands.html#Shared-Library-GDB_002fMI-Catchpoint-Commands" rel="prev" title="Shared Library 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="Ada-Exception-GDB_002fMI-Catchpoint-Commands"></a>

  64. <div class="header">

  65. <p>

  66. Next: <a href="C_002b_002b-Exception-GDB_002fMI-Catchpoint-Commands.html#C_002b_002b-Exception-GDB_002fMI-Catchpoint-Commands" accesskey="n" rel="next">C++ Exception GDB/MI Catchpoint Commands</a>, Previous: <a href="Shared-Library-GDB_002fMI-Catchpoint-Commands.html#Shared-Library-GDB_002fMI-Catchpoint-Commands" accesskey="p" rel="prev">Shared Library 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="Ada-Exception-GDB_002fMI-Catchpoints"></a>

  70. <h4 class="subsection">27.9.2 Ada 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 Ada exceptions are being raised.

  74. </p>

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

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

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

  78. 

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

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

  81. 

  82. <div class="smallexample">

  83. <pre class="smallexample"> -catch-assert [ -c <var>condition</var>] [ -d ] [ -t ]

  84. </pre></div>

  85. 

  86. <p>Add a catchpoint for failed Ada assertions.

  87. </p>

  88. <p>The possible optional parameters for this command are:

  89. </p>

  90. <dl compact="compact">

  91. <dt>&lsquo;<samp>-c <var>condition</var></samp>&rsquo;</dt>

  92. <dd><p>Make the catchpoint conditional on <var>condition</var>.

  93. </p></dd>

  94. <dt>&lsquo;<samp>-d</samp>&rsquo;</dt>

  95. <dd><p>Create a disabled catchpoint.

  96. </p></dd>

  97. <dt>&lsquo;<samp>-t</samp>&rsquo;</dt>

  98. <dd><p>Create a temporary catchpoint.

  99. </p></dd>

  100. </dl>

  101. 

  102. <a name="GDB-Command-14"></a>

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

  104. 

  105. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>catch assert</samp>&rsquo;.

  106. </p>

  107. <a name="Example-14"></a>

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

  109. 

  110. <div class="smallexample">

  111. <pre class="smallexample">-catch-assert

  112. ^done,bkptno=&quot;5&quot;,bkpt={number=&quot;5&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,

  113. enabled=&quot;y&quot;,addr=&quot;0x0000000000404888&quot;,what=&quot;failed Ada assertions&quot;,

  114. thread-groups=[&quot;i1&quot;],times=&quot;0&quot;,

  115. original-location=&quot;__gnat_debug_raise_assert_failure&quot;}

  116. (gdb)

  117. </pre></div>

  118. 

  119. <a name="The-_002dcatch_002dexception-Command"></a>

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

  121. <a name="index-_002dcatch_002dexception"></a>

  122. 

  123. <a name="Synopsis-16"></a>

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

  125. 

  126. <div class="smallexample">

  127. <pre class="smallexample"> -catch-exception [ -c <var>condition</var>] [ -d ] [ -e <var>exception-name</var> ]

  128.     [ -t ] [ -u ]

  129. </pre></div>

  130. 

  131. <p>Add a catchpoint stopping when Ada exceptions are raised.

  132. By default, the command stops the program when any Ada exception

  133. gets raised.  But it is also possible, by using some of the

  134. optional parameters described below, to create more selective

  135. catchpoints.

  136. </p>

  137. <p>The possible optional parameters for this command are:

  138. </p>

  139. <dl compact="compact">

  140. <dt>&lsquo;<samp>-c <var>condition</var></samp>&rsquo;</dt>

  141. <dd><p>Make the catchpoint conditional on <var>condition</var>.

  142. </p></dd>

  143. <dt>&lsquo;<samp>-d</samp>&rsquo;</dt>

  144. <dd><p>Create a disabled catchpoint.

  145. </p></dd>

  146. <dt>&lsquo;<samp>-e <var>exception-name</var></samp>&rsquo;</dt>

  147. <dd><p>Only stop when <var>exception-name</var> is raised.  This option cannot

  148. be used combined with &lsquo;<samp>-u</samp>&rsquo;.

  149. </p></dd>

  150. <dt>&lsquo;<samp>-t</samp>&rsquo;</dt>

  151. <dd><p>Create a temporary catchpoint.

  152. </p></dd>

  153. <dt>&lsquo;<samp>-u</samp>&rsquo;</dt>

  154. <dd><p>Stop only when an unhandled exception gets raised.  This option

  155. cannot be used combined with &lsquo;<samp>-e</samp>&rsquo;.

  156. </p></dd>

  157. </dl>

  158. 

  159. <a name="GDB-Command-15"></a>

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

  161. 

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

  163. and &lsquo;<samp>catch exception unhandled</samp>&rsquo;.

  164. </p>

  165. <a name="Example-15"></a>

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

  167. 

  168. <div class="smallexample">

  169. <pre class="smallexample">-catch-exception -e Program_Error

  170. ^done,bkptno=&quot;4&quot;,bkpt={number=&quot;4&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,

  171. enabled=&quot;y&quot;,addr=&quot;0x0000000000404874&quot;,

  172. what=&quot;`Program_Error' Ada exception&quot;, thread-groups=[&quot;i1&quot;],

  173. times=&quot;0&quot;,original-location=&quot;__gnat_debug_raise_exception&quot;}

  174. (gdb)

  175. </pre></div>

  176. 

  177. <a name="The-_002dcatch_002dhandlers-Command"></a>

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

  179. <a name="index-_002dcatch_002dhandlers"></a>

  180. 

  181. <a name="Synopsis-17"></a>

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

  183. 

  184. <div class="smallexample">

  185. <pre class="smallexample"> -catch-handlers [ -c <var>condition</var>] [ -d ] [ -e <var>exception-name</var> ]

  186.     [ -t ]

  187. </pre></div>

  188. 

  189. <p>Add a catchpoint stopping when Ada exceptions are handled.

  190. By default, the command stops the program when any Ada exception

  191. gets handled.  But it is also possible, by using some of the

  192. optional parameters described below, to create more selective

  193. catchpoints.

  194. </p>

  195. <p>The possible optional parameters for this command are:

  196. </p>

  197. <dl compact="compact">

  198. <dt>&lsquo;<samp>-c <var>condition</var></samp>&rsquo;</dt>

  199. <dd><p>Make the catchpoint conditional on <var>condition</var>.

  200. </p></dd>

  201. <dt>&lsquo;<samp>-d</samp>&rsquo;</dt>

  202. <dd><p>Create a disabled catchpoint.

  203. </p></dd>

  204. <dt>&lsquo;<samp>-e <var>exception-name</var></samp>&rsquo;</dt>

  205. <dd><p>Only stop when <var>exception-name</var> is handled.

  206. </p></dd>

  207. <dt>&lsquo;<samp>-t</samp>&rsquo;</dt>

  208. <dd><p>Create a temporary catchpoint.

  209. </p></dd>

  210. </dl>

  211. 

  212. <a name="GDB-Command-16"></a>

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

  214. 

  215. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>catch handlers</samp>&rsquo;.

  216. </p>

  217. <a name="Example-16"></a>

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

  219. 

  220. <div class="smallexample">

  221. <pre class="smallexample">-catch-handlers -e Constraint_Error

  222. ^done,bkptno=&quot;4&quot;,bkpt={number=&quot;4&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,

  223. enabled=&quot;y&quot;,addr=&quot;0x0000000000402f68&quot;,

  224. what=&quot;`Constraint_Error' Ada exception handlers&quot;,thread-groups=[&quot;i1&quot;],

  225. times=&quot;0&quot;,original-location=&quot;__gnat_begin_handler&quot;}

  226. (gdb)

  227. </pre></div>

  228. 

  229. <hr>

  230. <div class="header">

  231. <p>

  232. Next: <a href="C_002b_002b-Exception-GDB_002fMI-Catchpoint-Commands.html#C_002b_002b-Exception-GDB_002fMI-Catchpoint-Commands" accesskey="n" rel="next">C++ Exception GDB/MI Catchpoint Commands</a>, Previous: <a href="Shared-Library-GDB_002fMI-Catchpoint-Commands.html#Shared-Library-GDB_002fMI-Catchpoint-Commands" accesskey="p" rel="prev">Shared Library 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>

  233. </div>

  234. 

  235. 

  236. 

  237. </body>

  238. </html>