首頁 探索 說明
註冊 登入
huangmeng
/
asj_pe_project
1
0
複刻 0
Files 問題管理 0 合併請求 0 Wiki
目錄樹: bbf3a35d42
分支列表 標籤列表
asj_pe_project
/
tools
/
gcc-arm-10.2-2020.11-x86_64-aarch64-none-linux-gnu
/
share
/
doc
/
gdb
/
GDB_002fMI-Breakpoint-Commands.html

GDB_002fMI-Breakpoint-Commands.html 37 KB
文件歷史 原始文件

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3. <!-- Copyright (C) 1988-2020 Free Software Foundation, Inc.
    4. 

  4. 

  5. Permission is granted to copy, distribute and/or modify this document
    6. 

  6. under the terms of the GNU Free Documentation License, Version 1.3 or
    7. 

  7. any later version published by the Free Software Foundation; with the
    8. 

  8. Invariant Sections being "Free Software" and "Free Software Needs
    9. 

  9. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
    10. 

  10. and with the Back-Cover Texts as in (a) below.
    11. 

  11. 

  12. (a) The FSF's Back-Cover Text is: "You are free to copy and modify
    13. 

  13. this GNU Manual.  Buying copies from GNU Press supports the FSF in
    14. 

  14. developing GNU and promoting software freedom." -->
    15. 

  15. <!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
    16. 

  16. <head>
    17. 

  17. <title>Debugging with GDB: GDB/MI Breakpoint Commands</title>
    18. 

  18. 

  19. <meta name="description" content="Debugging with GDB: GDB/MI Breakpoint Commands">
    20. 

  20. <meta name="keywords" content="Debugging with GDB: GDB/MI Breakpoint Commands">
    21. 

  21. <meta name="resource-type" content="document">
    22. 

  22. <meta name="distribution" content="global">
    23. 

  23. <meta name="Generator" content="makeinfo">
    24. 

  24. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    25. 

  25. <link href="index.html#Top" rel="start" title="Top">
    26. 

  26. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
    27. 

  27. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    28. 

  28. <link href="GDB_002fMI.html#GDB_002fMI" rel="up" title="GDB/MI">
    29. 

  29. <link href="GDB_002fMI-Catchpoint-Commands.html#GDB_002fMI-Catchpoint-Commands" rel="next" title="GDB/MI Catchpoint Commands">
    30. 

  30. <link href="GDB_002fMI-Command-Description-Format.html#GDB_002fMI-Command-Description-Format" rel="previous" title="GDB/MI Command Description Format">
    31. 

  31. <style type="text/css">
    32. 

  32. <!--
    33. 

  33. a.summary-letter {text-decoration: none}
    34. 

  34. blockquote.smallquotation {font-size: smaller}
    35. 

  35. div.display {margin-left: 3.2em}
    36. 

  36. div.example {margin-left: 3.2em}
    37. 

  37. div.indentedblock {margin-left: 3.2em}
    38. 

  38. div.lisp {margin-left: 3.2em}
    39. 

  39. div.smalldisplay {margin-left: 3.2em}
    40. 

  40. div.smallexample {margin-left: 3.2em}
    41. 

  41. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    42. 

  42. div.smalllisp {margin-left: 3.2em}
    43. 

  43. kbd {font-style:oblique}
    44. 

  44. pre.display {font-family: inherit}
    45. 

  45. pre.format {font-family: inherit}
    46. 

  46. pre.menu-comment {font-family: serif}
    47. 

  47. pre.menu-preformatted {font-family: serif}
    48. 

  48. pre.smalldisplay {font-family: inherit; font-size: smaller}
    49. 

  49. pre.smallexample {font-size: smaller}
    50. 

  50. pre.smallformat {font-family: inherit; font-size: smaller}
    51. 

  51. pre.smalllisp {font-size: smaller}
    52. 

  52. span.nocodebreak {white-space:nowrap}
    53. 

  53. span.nolinebreak {white-space:nowrap}
    54. 

  54. span.roman {font-family:serif; font-weight:normal}
    55. 

  55. span.sansserif {font-family:sans-serif; font-weight:normal}
    56. 

  56. ul.no-bullet {list-style: none}
    57. 

  57. -->
    58. 

  58. </style>
    59. 

  59. 

  60. 

  61. </head>
    62. 

  62. 

  63. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    64. 

  64. <a name="GDB_002fMI-Breakpoint-Commands"></a>
    65. 

  65. <div class="header">
    66. 

  66. <p>
    67. 

  67. Next: <a href="GDB_002fMI-Catchpoint-Commands.html#GDB_002fMI-Catchpoint-Commands" accesskey="n" rel="next">GDB/MI Catchpoint Commands</a>, Previous: <a href="GDB_002fMI-Command-Description-Format.html#GDB_002fMI-Command-Description-Format" accesskey="p" rel="previous">GDB/MI Command Description Format</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>
    68. 

  68. </div>
    69. 

  69. <hr>
    70. 

  70. <a name="GDB_002fMI-Breakpoint-Commands-1"></a>
    71. 

  71. <h3 class="section">27.8 <small>GDB/MI</small> Breakpoint Commands</h3>
    72. 

  72. 

  73. <a name="index-breakpoint-commands-for-GDB_002fMI"></a>
    74. 

  74. <a name="index-GDB_002fMI_002c-breakpoint-commands"></a>
    75. 

  75. <p>This section documents <small>GDB/MI</small> commands for manipulating
    76. 

  76. breakpoints.
    77. 

  77. </p>
    78. 

  78. <a name="The-_002dbreak_002dafter-Command"></a>
    79. 

  79. <h4 class="subheading">The <code>-break-after</code> Command</h4>
    80. 

  80. <a name="index-_002dbreak_002dafter"></a>
    81. 

  81. 

  82. <a name="Synopsis-1"></a>
    83. 

  83. <h4 class="subsubheading">Synopsis</h4>
    84. 

  84. 

  85. <div class="smallexample">
    86. 

  86. <pre class="smallexample"> -break-after <var>number</var> <var>count</var>
    87. 

  87. </pre></div>
    88. 

  88. 

  89. <p>The breakpoint number <var>number</var> is not in effect until it has been
    90. 

  90. hit <var>count</var> times.  To see how this is reflected in the output of
    91. 

  91. the &lsquo;<samp>-break-list</samp>&rsquo; command, see the description of the
    92. 

  92. &lsquo;<samp>-break-list</samp>&rsquo; command below.
    93. 

  93. </p>
    94. 

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

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

  96. 

  97. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>ignore</samp>&rsquo;.
    98. 

  98. </p>
    99. 

  99. <a name="Example-1"></a>
    100. 

  100. <h4 class="subsubheading">Example</h4>
    101. 

  101. 

  102. <div class="smallexample">
    103. 

  103. <pre class="smallexample">(gdb)
    104. 

  104. -break-insert main
    105. 

  105. ^done,bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,
    106. 

  106. enabled=&quot;y&quot;,addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,
    107. 

  107. fullname=&quot;/home/foo/hello.c&quot;,line=&quot;5&quot;,thread-groups=[&quot;i1&quot;],
    108. 

  108. times=&quot;0&quot;}
    109. 

  109. (gdb)
    110. 

  110. -break-after 1 3
    111. 

  111. ~
    112. 

  112. ^done
    113. 

  113. (gdb)
    114. 

  114. -break-list
    115. 

  115. ^done,BreakpointTable={nr_rows=&quot;1&quot;,nr_cols=&quot;6&quot;,
    116. 

  116. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    117. 

  117. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    118. 

  118. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    119. 

  119. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    120. 

  120. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    121. 

  121. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    122. 

  122. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    123. 

  123. addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,fullname=&quot;/home/foo/hello.c&quot;,
    124. 

  124. line=&quot;5&quot;,thread-groups=[&quot;i1&quot;],times=&quot;0&quot;,ignore=&quot;3&quot;}]}
    125. 

  125. (gdb)
    126. 

  126. </pre></div>
    127. 

  127. 

  128. 

  129. <a name="The-_002dbreak_002dcommands-Command"></a>
    130. 

  130. <h4 class="subheading">The <code>-break-commands</code> Command</h4>
    131. 

  131. <a name="index-_002dbreak_002dcommands"></a>
    132. 

  132. 

  133. <a name="Synopsis-2"></a>
    134. 

  134. <h4 class="subsubheading">Synopsis</h4>
    135. 

  135. 

  136. <div class="smallexample">
    137. 

  137. <pre class="smallexample"> -break-commands <var>number</var> [ <var>command1</var> ... <var>commandN</var> ]
    138. 

  138. </pre></div>
    139. 

  139. 

  140. <p>Specifies the CLI commands that should be executed when breakpoint
    141. 

  141. <var>number</var> is hit.  The parameters <var>command1</var> to <var>commandN</var>
    142. 

  142. are the commands.  If no command is specified, any previously-set
    143. 

  143. commands are cleared.  See <a href="Break-Commands.html#Break-Commands">Break Commands</a>.  Typical use of this
    144. 

  144. functionality is tracing a program, that is, printing of values of
    145. 

  145. some variables whenever breakpoint is hit and then continuing.
    146. 

  146. </p>
    147. 

  147. <a name="GDB-Command-2"></a>
    148. 

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

  149. 

  150. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>commands</samp>&rsquo;.
    151. 

  151. </p>
    152. 

  152. <a name="Example-2"></a>
    153. 

  153. <h4 class="subsubheading">Example</h4>
    154. 

  154. 

  155. <div class="smallexample">
    156. 

  156. <pre class="smallexample">(gdb)
    157. 

  157. -break-insert main
    158. 

  158. ^done,bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,
    159. 

  159. enabled=&quot;y&quot;,addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,
    160. 

  160. fullname=&quot;/home/foo/hello.c&quot;,line=&quot;5&quot;,thread-groups=[&quot;i1&quot;],
    161. 

  161. times=&quot;0&quot;}
    162. 

  162. (gdb)
    163. 

  163. -break-commands 1 &quot;print v&quot; &quot;continue&quot;
    164. 

  164. ^done
    165. 

  165. (gdb)
    166. 

  166. </pre></div>
    167. 

  167. 

  168. <a name="The-_002dbreak_002dcondition-Command"></a>
    169. 

  169. <h4 class="subheading">The <code>-break-condition</code> Command</h4>
    170. 

  170. <a name="index-_002dbreak_002dcondition"></a>
    171. 

  171. 

  172. <a name="Synopsis-3"></a>
    173. 

  173. <h4 class="subsubheading">Synopsis</h4>
    174. 

  174. 

  175. <div class="smallexample">
    176. 

  176. <pre class="smallexample"> -break-condition <var>number</var> <var>expr</var>
    177. 

  177. </pre></div>
    178. 

  178. 

  179. <p>Breakpoint <var>number</var> will stop the program only if the condition in
    180. 

  180. <var>expr</var> is true.  The condition becomes part of the
    181. 

  181. &lsquo;<samp>-break-list</samp>&rsquo; output (see the description of the &lsquo;<samp>-break-list</samp>&rsquo;
    182. 

  182. command below).
    183. 

  183. </p>
    184. 

  184. <a name="GDB-Command-3"></a>
    185. 

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

  186. 

  187. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>condition</samp>&rsquo;.
    188. 

  188. </p>
    189. 

  189. <a name="Example-3"></a>
    190. 

  190. <h4 class="subsubheading">Example</h4>
    191. 

  191. 

  192. <div class="smallexample">
    193. 

  193. <pre class="smallexample">(gdb)
    194. 

  194. -break-condition 1 1
    195. 

  195. ^done
    196. 

  196. (gdb)
    197. 

  197. -break-list
    198. 

  198. ^done,BreakpointTable={nr_rows=&quot;1&quot;,nr_cols=&quot;6&quot;,
    199. 

  199. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    200. 

  200. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    201. 

  201. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    202. 

  202. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    203. 

  203. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    204. 

  204. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    205. 

  205. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    206. 

  206. addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,fullname=&quot;/home/foo/hello.c&quot;,
    207. 

  207. line=&quot;5&quot;,cond=&quot;1&quot;,thread-groups=[&quot;i1&quot;],times=&quot;0&quot;,ignore=&quot;3&quot;}]}
    208. 

  208. (gdb)
    209. 

  209. </pre></div>
    210. 

  210. 

  211. <a name="The-_002dbreak_002ddelete-Command"></a>
    212. 

  212. <h4 class="subheading">The <code>-break-delete</code> Command</h4>
    213. 

  213. <a name="index-_002dbreak_002ddelete"></a>
    214. 

  214. 

  215. <a name="Synopsis-4"></a>
    216. 

  216. <h4 class="subsubheading">Synopsis</h4>
    217. 

  217. 

  218. <div class="smallexample">
    219. 

  219. <pre class="smallexample"> -break-delete ( <var>breakpoint</var> )+
    220. 

  220. </pre></div>
    221. 

  221. 

  222. <p>Delete the breakpoint(s) whose number(s) are specified in the argument
    223. 

  223. list.  This is obviously reflected in the breakpoint list.
    224. 

  224. </p>
    225. 

  225. <a name="GDB-Command-4"></a>
    226. 

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

  227. 

  228. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>delete</samp>&rsquo;.
    229. 

  229. </p>
    230. 

  230. <a name="Example-4"></a>
    231. 

  231. <h4 class="subsubheading">Example</h4>
    232. 

  232. 

  233. <div class="smallexample">
    234. 

  234. <pre class="smallexample">(gdb)
    235. 

  235. -break-delete 1
    236. 

  236. ^done
    237. 

  237. (gdb)
    238. 

  238. -break-list
    239. 

  239. ^done,BreakpointTable={nr_rows=&quot;0&quot;,nr_cols=&quot;6&quot;,
    240. 

  240. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    241. 

  241. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    242. 

  242. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    243. 

  243. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    244. 

  244. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    245. 

  245. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    246. 

  246. body=[]}
    247. 

  247. (gdb)
    248. 

  248. </pre></div>
    249. 

  249. 

  250. <a name="The-_002dbreak_002ddisable-Command"></a>
    251. 

  251. <h4 class="subheading">The <code>-break-disable</code> Command</h4>
    252. 

  252. <a name="index-_002dbreak_002ddisable"></a>
    253. 

  253. 

  254. <a name="Synopsis-5"></a>
    255. 

  255. <h4 class="subsubheading">Synopsis</h4>
    256. 

  256. 

  257. <div class="smallexample">
    258. 

  258. <pre class="smallexample"> -break-disable ( <var>breakpoint</var> )+
    259. 

  259. </pre></div>
    260. 

  260. 

  261. <p>Disable the named <var>breakpoint</var>(s).  The field &lsquo;<samp>enabled</samp>&rsquo; in the
    262. 

  262. break list is now set to &lsquo;<samp>n</samp>&rsquo; for the named <var>breakpoint</var>(s).
    263. 

  263. </p>
    264. 

  264. <a name="GDB-Command-5"></a>
    265. 

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

  266. 

  267. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>disable</samp>&rsquo;.
    268. 

  268. </p>
    269. 

  269. <a name="Example-5"></a>
    270. 

  270. <h4 class="subsubheading">Example</h4>
    271. 

  271. 

  272. <div class="smallexample">
    273. 

  273. <pre class="smallexample">(gdb)
    274. 

  274. -break-disable 2
    275. 

  275. ^done
    276. 

  276. (gdb)
    277. 

  277. -break-list
    278. 

  278. ^done,BreakpointTable={nr_rows=&quot;1&quot;,nr_cols=&quot;6&quot;,
    279. 

  279. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    280. 

  280. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    281. 

  281. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    282. 

  282. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    283. 

  283. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    284. 

  284. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    285. 

  285. body=[bkpt={number=&quot;2&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;n&quot;,
    286. 

  286. addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,fullname=&quot;/home/foo/hello.c&quot;,
    287. 

  287. line=&quot;5&quot;,thread-groups=[&quot;i1&quot;],times=&quot;0&quot;}]}
    288. 

  288. (gdb)
    289. 

  289. </pre></div>
    290. 

  290. 

  291. <a name="The-_002dbreak_002denable-Command"></a>
    292. 

  292. <h4 class="subheading">The <code>-break-enable</code> Command</h4>
    293. 

  293. <a name="index-_002dbreak_002denable"></a>
    294. 

  294. 

  295. <a name="Synopsis-6"></a>
    296. 

  296. <h4 class="subsubheading">Synopsis</h4>
    297. 

  297. 

  298. <div class="smallexample">
    299. 

  299. <pre class="smallexample"> -break-enable ( <var>breakpoint</var> )+
    300. 

  300. </pre></div>
    301. 

  301. 

  302. <p>Enable (previously disabled) <var>breakpoint</var>(s).
    303. 

  303. </p>
    304. 

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

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

  306. 

  307. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>enable</samp>&rsquo;.
    308. 

  308. </p>
    309. 

  309. <a name="Example-6"></a>
    310. 

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

  311. 

  312. <div class="smallexample">
    313. 

  313. <pre class="smallexample">(gdb)
    314. 

  314. -break-enable 2
    315. 

  315. ^done
    316. 

  316. (gdb)
    317. 

  317. -break-list
    318. 

  318. ^done,BreakpointTable={nr_rows=&quot;1&quot;,nr_cols=&quot;6&quot;,
    319. 

  319. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    320. 

  320. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    321. 

  321. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    322. 

  322. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    323. 

  323. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    324. 

  324. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    325. 

  325. body=[bkpt={number=&quot;2&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    326. 

  326. addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,fullname=&quot;/home/foo/hello.c&quot;,
    327. 

  327. line=&quot;5&quot;,thread-groups=[&quot;i1&quot;],times=&quot;0&quot;}]}
    328. 

  328. (gdb)
    329. 

  329. </pre></div>
    330. 

  330. 

  331. <a name="The-_002dbreak_002dinfo-Command"></a>
    332. 

  332. <h4 class="subheading">The <code>-break-info</code> Command</h4>
    333. 

  333. <a name="index-_002dbreak_002dinfo"></a>
    334. 

  334. 

  335. <a name="Synopsis-7"></a>
    336. 

  336. <h4 class="subsubheading">Synopsis</h4>
    337. 

  337. 

  338. <div class="smallexample">
    339. 

  339. <pre class="smallexample"> -break-info <var>breakpoint</var>
    340. 

  340. </pre></div>
    341. 

  341. 

  342. <p>Get information about a single breakpoint.
    343. 

  343. </p>
    344. 

  344. <p>The result is a table of breakpoints.  See <a href="GDB_002fMI-Breakpoint-Information.html#GDB_002fMI-Breakpoint-Information">GDB/MI Breakpoint Information</a>, for details on the format of each breakpoint in the
    345. 

  345. table.
    346. 

  346. </p>
    347. 

  347. <a name="GDB-Command-7"></a>
    348. 

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

  349. 

  350. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>info break <var>breakpoint</var></samp>&rsquo;.
    351. 

  351. </p>
    352. 

  352. <a name="Example-7"></a>
    353. 

  353. <h4 class="subsubheading">Example</h4>
    354. 

  354. <p>N.A.
    355. 

  355. </p>
    356. 

  356. <a name="The-_002dbreak_002dinsert-Command"></a>
    357. 

  357. <h4 class="subheading">The <code>-break-insert</code> Command</h4>
    358. 

  358. <a name="index-_002dbreak_002dinsert"></a>
    359. 

  359. <a name="g_t_002dbreak_002dinsert"></a>
    360. 

  360. <a name="Synopsis-8"></a>
    361. 

  361. <h4 class="subsubheading">Synopsis</h4>
    362. 

  362. 

  363. <div class="smallexample">
    364. 

  364. <pre class="smallexample"> -break-insert [ -t ] [ -h ] [ -f ] [ -d ] [ -a ]
    365. 

  365.     [ -c <var>condition</var> ] [ -i <var>ignore-count</var> ]
    366. 

  366.     [ -p <var>thread-id</var> ] [ <var>location</var> ]
    367. 

  367. </pre></div>
    368. 

  368. 

  369. <p>If specified, <var>location</var>, can be one of:
    370. 

  370. </p>
    371. 

  371. <dl compact="compact">
    372. 

  372. <dt><var>linespec location</var></dt>
    373. 

  373. <dd><p>A linespec location.  See <a href="Linespec-Locations.html#Linespec-Locations">Linespec Locations</a>.
    374. 

  374. </p>
    375. 

  375. </dd>
    376. 

  376. <dt><var>explicit location</var></dt>
    377. 

  377. <dd><p>An explicit location.  <small>GDB/MI</small> explicit locations are
    378. 

  378. analogous to the CLI&rsquo;s explicit locations using the option names
    379. 

  379. listed below.  See <a href="Explicit-Locations.html#Explicit-Locations">Explicit Locations</a>.
    380. 

  380. </p>
    381. 

  381. <dl compact="compact">
    382. 

  382. <dt>&lsquo;<samp>--source <var>filename</var></samp>&rsquo;</dt>
    383. 

  383. <dd><p>The source file name of the location.  This option requires the use
    384. 

  384. of either &lsquo;<samp>--function</samp>&rsquo; or &lsquo;<samp>--line</samp>&rsquo;.
    385. 

  385. </p>
    386. 

  386. </dd>
    387. 

  387. <dt>&lsquo;<samp>--function <var>function</var></samp>&rsquo;</dt>
    388. 

  388. <dd><p>The name of a function or method.
    389. 

  389. </p>
    390. 

  390. </dd>
    391. 

  391. <dt>&lsquo;<samp>--label <var>label</var></samp>&rsquo;</dt>
    392. 

  392. <dd><p>The name of a label.
    393. 

  393. </p>
    394. 

  394. </dd>
    395. 

  395. <dt>&lsquo;<samp>--line <var>lineoffset</var></samp>&rsquo;</dt>
    396. 

  396. <dd><p>An absolute or relative line offset from the start of the location.
    397. 

  397. </p></dd>
    398. 

  398. </dl>
    399. 

  399. 

  400. </dd>
    401. 

  401. <dt><var>address location</var></dt>
    402. 

  402. <dd><p>An address location, *<var>address</var>.  See <a href="Address-Locations.html#Address-Locations">Address Locations</a>.
    403. 

  403. </p></dd>
    404. 

  404. </dl>
    405. 

  405. 

  406. <p>The possible optional parameters of this command are:
    407. 

  407. </p>
    408. 

  408. <dl compact="compact">
    409. 

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

  410. <dd><p>Insert a temporary breakpoint.
    411. 

  411. </p></dd>
    412. 

  412. <dt>&lsquo;<samp>-h</samp>&rsquo;</dt>
    413. 

  413. <dd><p>Insert a hardware breakpoint.
    414. 

  414. </p></dd>
    415. 

  415. <dt>&lsquo;<samp>-f</samp>&rsquo;</dt>
    416. 

  416. <dd><p>If <var>location</var> cannot be parsed (for example if it
    417. 

  417. refers to unknown files or functions), create a pending
    418. 

  418. breakpoint. Without this flag, <small>GDB</small> will report
    419. 

  419. an error, and won&rsquo;t create a breakpoint, if <var>location</var>
    420. 

  420. cannot be parsed.
    421. 

  421. </p></dd>
    422. 

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

  423. <dd><p>Create a disabled breakpoint.
    424. 

  424. </p></dd>
    425. 

  425. <dt>&lsquo;<samp>-a</samp>&rsquo;</dt>
    426. 

  426. <dd><p>Create a tracepoint.  See <a href="Tracepoints.html#Tracepoints">Tracepoints</a>.  When this parameter
    427. 

  427. is used together with &lsquo;<samp>-h</samp>&rsquo;, a fast tracepoint is created.
    428. 

  428. </p></dd>
    429. 

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

  430. <dd><p>Make the breakpoint conditional on <var>condition</var>.
    431. 

  431. </p></dd>
    432. 

  432. <dt>&lsquo;<samp>-i <var>ignore-count</var></samp>&rsquo;</dt>
    433. 

  433. <dd><p>Initialize the <var>ignore-count</var>.
    434. 

  434. </p></dd>
    435. 

  435. <dt>&lsquo;<samp>-p <var>thread-id</var></samp>&rsquo;</dt>
    436. 

  436. <dd><p>Restrict the breakpoint to the thread with the specified global
    437. 

  437. <var>thread-id</var>.
    438. 

  438. </p></dd>
    439. 

  439. </dl>
    440. 

  440. 

  441. <a name="Result-1"></a>
    442. 

  442. <h4 class="subsubheading">Result</h4>
    443. 

  443. 

  444. <p>See <a href="GDB_002fMI-Breakpoint-Information.html#GDB_002fMI-Breakpoint-Information">GDB/MI Breakpoint Information</a>, for details on the format of the
    445. 

  445. resulting breakpoint.
    446. 

  446. </p>
    447. 

  447. <p>Note: this format is open to change.
    448. 

  448. </p>
    449. 

  449. <a name="GDB-Command-8"></a>
    450. 

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

  451. 

  452. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>break</samp>&rsquo;, &lsquo;<samp>tbreak</samp>&rsquo;,
    453. 

  453. &lsquo;<samp>hbreak</samp>&rsquo;, and &lsquo;<samp>thbreak</samp>&rsquo;. </p>
    454. 

  454. <a name="Example-8"></a>
    455. 

  455. <h4 class="subsubheading">Example</h4>
    456. 

  456. 

  457. <div class="smallexample">
    458. 

  458. <pre class="smallexample">(gdb)
    459. 

  459. -break-insert main
    460. 

  460. ^done,bkpt={number=&quot;1&quot;,addr=&quot;0x0001072c&quot;,file=&quot;recursive2.c&quot;,
    461. 

  461. fullname=&quot;/home/foo/recursive2.c,line=&quot;4&quot;,thread-groups=[&quot;i1&quot;],
    462. 

  462. times=&quot;0&quot;}
    463. 

  463. (gdb)
    464. 

  464. -break-insert -t foo
    465. 

  465. ^done,bkpt={number=&quot;2&quot;,addr=&quot;0x00010774&quot;,file=&quot;recursive2.c&quot;,
    466. 

  466. fullname=&quot;/home/foo/recursive2.c,line=&quot;11&quot;,thread-groups=[&quot;i1&quot;],
    467. 

  467. times=&quot;0&quot;}
    468. 

  468. (gdb)
    469. 

  469. -break-list
    470. 

  470. ^done,BreakpointTable={nr_rows=&quot;2&quot;,nr_cols=&quot;6&quot;,
    471. 

  471. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    472. 

  472. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    473. 

  473. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    474. 

  474. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    475. 

  475. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    476. 

  476. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    477. 

  477. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    478. 

  478. addr=&quot;0x0001072c&quot;, func=&quot;main&quot;,file=&quot;recursive2.c&quot;,
    479. 

  479. fullname=&quot;/home/foo/recursive2.c,&quot;line=&quot;4&quot;,thread-groups=[&quot;i1&quot;],
    480. 

  480. times=&quot;0&quot;},
    481. 

  481. bkpt={number=&quot;2&quot;,type=&quot;breakpoint&quot;,disp=&quot;del&quot;,enabled=&quot;y&quot;,
    482. 

  482. addr=&quot;0x00010774&quot;,func=&quot;foo&quot;,file=&quot;recursive2.c&quot;,
    483. 

  483. fullname=&quot;/home/foo/recursive2.c&quot;,line=&quot;11&quot;,thread-groups=[&quot;i1&quot;],
    484. 

  484. times=&quot;0&quot;}]}
    485. 

  485. (gdb)
    486. 

  486. </pre></div>
    487. 

  487. 

  488. <a name="The-_002ddprintf_002dinsert-Command"></a>
    489. 

  489. <h4 class="subheading">The <code>-dprintf-insert</code> Command</h4>
    490. 

  490. <a name="index-_002ddprintf_002dinsert"></a>
    491. 

  491. 

  492. <a name="Synopsis-9"></a>
    493. 

  493. <h4 class="subsubheading">Synopsis</h4>
    494. 

  494. 

  495. <div class="smallexample">
    496. 

  496. <pre class="smallexample"> -dprintf-insert [ -t ] [ -f ] [ -d ]
    497. 

  497.     [ -c <var>condition</var> ] [ -i <var>ignore-count</var> ]
    498. 

  498.     [ -p <var>thread-id</var> ] [ <var>location</var> ] [ <var>format</var> ]
    499. 

  499.     [ <var>argument</var> ]
    500. 

  500. </pre></div>
    501. 

  501. 

  502. <p>If supplied, <var>location</var> may be specified the same way as for
    503. 

  503. the <code>-break-insert</code> command.  See <a href="#g_t_002dbreak_002dinsert">-break-insert</a>.
    504. 

  504. </p>
    505. 

  505. <p>The possible optional parameters of this command are:
    506. 

  506. </p>
    507. 

  507. <dl compact="compact">
    508. 

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

  509. <dd><p>Insert a temporary breakpoint.
    510. 

  510. </p></dd>
    511. 

  511. <dt>&lsquo;<samp>-f</samp>&rsquo;</dt>
    512. 

  512. <dd><p>If <var>location</var> cannot be parsed (for example, if it
    513. 

  513. refers to unknown files or functions), create a pending
    514. 

  514. breakpoint.  Without this flag, <small>GDB</small> will report
    515. 

  515. an error, and won&rsquo;t create a breakpoint, if <var>location</var>
    516. 

  516. cannot be parsed.
    517. 

  517. </p></dd>
    518. 

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

  519. <dd><p>Create a disabled breakpoint.
    520. 

  520. </p></dd>
    521. 

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

  522. <dd><p>Make the breakpoint conditional on <var>condition</var>.
    523. 

  523. </p></dd>
    524. 

  524. <dt>&lsquo;<samp>-i <var>ignore-count</var></samp>&rsquo;</dt>
    525. 

  525. <dd><p>Set the ignore count of the breakpoint (see <a href="Conditions.html#Conditions">ignore count</a>)
    526. 

  526. to <var>ignore-count</var>.
    527. 

  527. </p></dd>
    528. 

  528. <dt>&lsquo;<samp>-p <var>thread-id</var></samp>&rsquo;</dt>
    529. 

  529. <dd><p>Restrict the breakpoint to the thread with the specified global
    530. 

  530. <var>thread-id</var>.
    531. 

  531. </p></dd>
    532. 

  532. </dl>
    533. 

  533. 

  534. <a name="Result-2"></a>
    535. 

  535. <h4 class="subsubheading">Result</h4>
    536. 

  536. 

  537. <p>See <a href="GDB_002fMI-Breakpoint-Information.html#GDB_002fMI-Breakpoint-Information">GDB/MI Breakpoint Information</a>, for details on the format of the
    538. 

  538. resulting breakpoint.
    539. 

  539. </p>
    540. 

  540. 

  541. <a name="GDB-Command-9"></a>
    542. 

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

  543. 

  544. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>dprintf</samp>&rsquo;.
    545. 

  545. </p>
    546. 

  546. <a name="Example-9"></a>
    547. 

  547. <h4 class="subsubheading">Example</h4>
    548. 

  548. 

  549. <div class="smallexample">
    550. 

  550. <pre class="smallexample">(gdb)
    551. 

  551. 4-dprintf-insert foo &quot;At foo entry\n&quot;
    552. 

  552. 4^done,bkpt={number=&quot;1&quot;,type=&quot;dprintf&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    553. 

  553. addr=&quot;0x000000000040061b&quot;,func=&quot;foo&quot;,file=&quot;mi-dprintf.c&quot;,
    554. 

  554. fullname=&quot;mi-dprintf.c&quot;,line=&quot;25&quot;,thread-groups=[&quot;i1&quot;],
    555. 

  555. times=&quot;0&quot;,script={&quot;printf \&quot;At foo entry\\n\&quot;&quot;,&quot;continue&quot;},
    556. 

  556. original-location=&quot;foo&quot;}
    557. 

  557. (gdb)
    558. 

  558. 5-dprintf-insert 26 &quot;arg=%d, g=%d\n&quot; arg g
    559. 

  559. 5^done,bkpt={number=&quot;2&quot;,type=&quot;dprintf&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    560. 

  560. addr=&quot;0x000000000040062a&quot;,func=&quot;foo&quot;,file=&quot;mi-dprintf.c&quot;,
    561. 

  561. fullname=&quot;mi-dprintf.c&quot;,line=&quot;26&quot;,thread-groups=[&quot;i1&quot;],
    562. 

  562. times=&quot;0&quot;,script={&quot;printf \&quot;arg=%d, g=%d\\n\&quot;, arg, g&quot;,&quot;continue&quot;},
    563. 

  563. original-location=&quot;mi-dprintf.c:26&quot;}
    564. 

  564. (gdb)
    565. 

  565. </pre></div>
    566. 

  566. 

  567. <a name="The-_002dbreak_002dlist-Command"></a>
    568. 

  568. <h4 class="subheading">The <code>-break-list</code> Command</h4>
    569. 

  569. <a name="index-_002dbreak_002dlist"></a>
    570. 

  570. 

  571. <a name="Synopsis-10"></a>
    572. 

  572. <h4 class="subsubheading">Synopsis</h4>
    573. 

  573. 

  574. <div class="smallexample">
    575. 

  575. <pre class="smallexample"> -break-list
    576. 

  576. </pre></div>
    577. 

  577. 

  578. <p>Displays the list of inserted breakpoints, showing the following fields:
    579. 

  579. </p>
    580. 

  580. <dl compact="compact">
    581. 

  581. <dt>&lsquo;<samp>Number</samp>&rsquo;</dt>
    582. 

  582. <dd><p>number of the breakpoint
    583. 

  583. </p></dd>
    584. 

  584. <dt>&lsquo;<samp>Type</samp>&rsquo;</dt>
    585. 

  585. <dd><p>type of the breakpoint: &lsquo;<samp>breakpoint</samp>&rsquo; or &lsquo;<samp>watchpoint</samp>&rsquo;
    586. 

  586. </p></dd>
    587. 

  587. <dt>&lsquo;<samp>Disposition</samp>&rsquo;</dt>
    588. 

  588. <dd><p>should the breakpoint be deleted or disabled when it is hit: &lsquo;<samp>keep</samp>&rsquo;
    589. 

  589. or &lsquo;<samp>nokeep</samp>&rsquo;
    590. 

  590. </p></dd>
    591. 

  591. <dt>&lsquo;<samp>Enabled</samp>&rsquo;</dt>
    592. 

  592. <dd><p>is the breakpoint enabled or no: &lsquo;<samp>y</samp>&rsquo; or &lsquo;<samp>n</samp>&rsquo;
    593. 

  593. </p></dd>
    594. 

  594. <dt>&lsquo;<samp>Address</samp>&rsquo;</dt>
    595. 

  595. <dd><p>memory location at which the breakpoint is set
    596. 

  596. </p></dd>
    597. 

  597. <dt>&lsquo;<samp>What</samp>&rsquo;</dt>
    598. 

  598. <dd><p>logical location of the breakpoint, expressed by function name, file
    599. 

  599. name, line number
    600. 

  600. </p></dd>
    601. 

  601. <dt>&lsquo;<samp>Thread-groups</samp>&rsquo;</dt>
    602. 

  602. <dd><p>list of thread groups to which this breakpoint applies
    603. 

  603. </p></dd>
    604. 

  604. <dt>&lsquo;<samp>Times</samp>&rsquo;</dt>
    605. 

  605. <dd><p>number of times the breakpoint has been hit
    606. 

  606. </p></dd>
    607. 

  607. </dl>
    608. 

  608. 

  609. <p>If there are no breakpoints or watchpoints, the <code>BreakpointTable</code>
    610. 

  610. <code>body</code> field is an empty list.
    611. 

  611. </p>
    612. 

  612. <a name="GDB-Command-10"></a>
    613. 

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

  614. 

  615. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>info break</samp>&rsquo;.
    616. 

  616. </p>
    617. 

  617. <a name="Example-10"></a>
    618. 

  618. <h4 class="subsubheading">Example</h4>
    619. 

  619. 

  620. <div class="smallexample">
    621. 

  621. <pre class="smallexample">(gdb)
    622. 

  622. -break-list
    623. 

  623. ^done,BreakpointTable={nr_rows=&quot;2&quot;,nr_cols=&quot;6&quot;,
    624. 

  624. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    625. 

  625. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    626. 

  626. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    627. 

  627. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    628. 

  628. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    629. 

  629. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    630. 

  630. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    631. 

  631. addr=&quot;0x000100d0&quot;,func=&quot;main&quot;,file=&quot;hello.c&quot;,line=&quot;5&quot;,thread-groups=[&quot;i1&quot;],
    632. 

  632. times=&quot;0&quot;},
    633. 

  633. bkpt={number=&quot;2&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    634. 

  634. addr=&quot;0x00010114&quot;,func=&quot;foo&quot;,file=&quot;hello.c&quot;,fullname=&quot;/home/foo/hello.c&quot;,
    635. 

  635. line=&quot;13&quot;,thread-groups=[&quot;i1&quot;],times=&quot;0&quot;}]}
    636. 

  636. (gdb)
    637. 

  637. </pre></div>
    638. 

  638. 

  639. <p>Here&rsquo;s an example of the result when there are no breakpoints:
    640. 

  640. </p>
    641. 

  641. <div class="smallexample">
    642. 

  642. <pre class="smallexample">(gdb)
    643. 

  643. -break-list
    644. 

  644. ^done,BreakpointTable={nr_rows=&quot;0&quot;,nr_cols=&quot;6&quot;,
    645. 

  645. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    646. 

  646. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    647. 

  647. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    648. 

  648. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    649. 

  649. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    650. 

  650. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    651. 

  651. body=[]}
    652. 

  652. (gdb)
    653. 

  653. </pre></div>
    654. 

  654. 

  655. <a name="The-_002dbreak_002dpasscount-Command"></a>
    656. 

  656. <h4 class="subheading">The <code>-break-passcount</code> Command</h4>
    657. 

  657. <a name="index-_002dbreak_002dpasscount"></a>
    658. 

  658. 

  659. <a name="Synopsis-11"></a>
    660. 

  660. <h4 class="subsubheading">Synopsis</h4>
    661. 

  661. 

  662. <div class="smallexample">
    663. 

  663. <pre class="smallexample"> -break-passcount <var>tracepoint-number</var> <var>passcount</var>
    664. 

  664. </pre></div>
    665. 

  665. 

  666. <p>Set the passcount for tracepoint <var>tracepoint-number</var> to
    667. 

  667. <var>passcount</var>.  If the breakpoint referred to by <var>tracepoint-number</var>
    668. 

  668. is not a tracepoint, error is emitted.  This corresponds to CLI
    669. 

  669. command &lsquo;<samp>passcount</samp>&rsquo;.
    670. 

  670. </p>
    671. 

  671. <a name="The-_002dbreak_002dwatch-Command"></a>
    672. 

  672. <h4 class="subheading">The <code>-break-watch</code> Command</h4>
    673. 

  673. <a name="index-_002dbreak_002dwatch"></a>
    674. 

  674. 

  675. <a name="Synopsis-12"></a>
    676. 

  676. <h4 class="subsubheading">Synopsis</h4>
    677. 

  677. 

  678. <div class="smallexample">
    679. 

  679. <pre class="smallexample"> -break-watch [ -a | -r ]
    680. 

  680. </pre></div>
    681. 

  681. 

  682. <p>Create a watchpoint.  With the &lsquo;<samp>-a</samp>&rsquo; option it will create an
    683. 

  683. <em>access</em> watchpoint, i.e., a watchpoint that triggers either on a
    684. 

  684. read from or on a write to the memory location.  With the &lsquo;<samp>-r</samp>&rsquo;
    685. 

  685. option, the watchpoint created is a <em>read</em> watchpoint, i.e., it will
    686. 

  686. trigger only when the memory location is accessed for reading.  Without
    687. 

  687. either of the options, the watchpoint created is a regular watchpoint,
    688. 

  688. i.e., it will trigger when the memory location is accessed for writing.
    689. 

  689. See <a href="Set-Watchpoints.html#Set-Watchpoints">Setting Watchpoints</a>.
    690. 

  690. </p>
    691. 

  691. <p>Note that &lsquo;<samp>-break-list</samp>&rsquo; will report a single list of watchpoints and
    692. 

  692. breakpoints inserted.
    693. 

  693. </p>
    694. 

  694. <a name="GDB-Command-11"></a>
    695. 

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

  696. 

  697. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>watch</samp>&rsquo;, &lsquo;<samp>awatch</samp>&rsquo;, and
    698. 

  698. &lsquo;<samp>rwatch</samp>&rsquo;.
    699. 

  699. </p>
    700. 

  700. <a name="Example-11"></a>
    701. 

  701. <h4 class="subsubheading">Example</h4>
    702. 

  702. 

  703. <p>Setting a watchpoint on a variable in the <code>main</code> function:
    704. 

  704. </p>
    705. 

  705. <div class="smallexample">
    706. 

  706. <pre class="smallexample">(gdb)
    707. 

  707. -break-watch x
    708. 

  708. ^done,wpt={number=&quot;2&quot;,exp=&quot;x&quot;}
    709. 

  709. (gdb)
    710. 

  710. -exec-continue
    711. 

  711. ^running
    712. 

  712. (gdb)
    713. 

  713. *stopped,reason=&quot;watchpoint-trigger&quot;,wpt={number=&quot;2&quot;,exp=&quot;x&quot;},
    714. 

  714. value={old=&quot;-268439212&quot;,new=&quot;55&quot;},
    715. 

  715. frame={func=&quot;main&quot;,args=[],file=&quot;recursive2.c&quot;,
    716. 

  716. fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;5&quot;,arch=&quot;i386:x86_64&quot;}
    717. 

  717. (gdb)
    718. 

  718. </pre></div>
    719. 

  719. 

  720. <p>Setting a watchpoint on a variable local to a function.  <small>GDB</small> will stop
    721. 

  721. the program execution twice: first for the variable changing value, then
    722. 

  722. for the watchpoint going out of scope.
    723. 

  723. </p>
    724. 

  724. <div class="smallexample">
    725. 

  725. <pre class="smallexample">(gdb)
    726. 

  726. -break-watch C
    727. 

  727. ^done,wpt={number=&quot;5&quot;,exp=&quot;C&quot;}
    728. 

  728. (gdb)
    729. 

  729. -exec-continue
    730. 

  730. ^running
    731. 

  731. (gdb)
    732. 

  732. *stopped,reason=&quot;watchpoint-trigger&quot;,
    733. 

  733. wpt={number=&quot;5&quot;,exp=&quot;C&quot;},value={old=&quot;-276895068&quot;,new=&quot;3&quot;},
    734. 

  734. frame={func=&quot;callee4&quot;,args=[],
    735. 

  735. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    736. 

  736. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;13&quot;,
    737. 

  737. arch=&quot;i386:x86_64&quot;}
    738. 

  738. (gdb)
    739. 

  739. -exec-continue
    740. 

  740. ^running
    741. 

  741. (gdb)
    742. 

  742. *stopped,reason=&quot;watchpoint-scope&quot;,wpnum=&quot;5&quot;,
    743. 

  743. frame={func=&quot;callee3&quot;,args=[{name=&quot;strarg&quot;,
    744. 

  744. value=&quot;0x11940 \&quot;A string argument.\&quot;&quot;}],
    745. 

  745. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    746. 

  746. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;18&quot;,
    747. 

  747. arch=&quot;i386:x86_64&quot;}
    748. 

  748. (gdb)
    749. 

  749. </pre></div>
    750. 

  750. 

  751. <p>Listing breakpoints and watchpoints, at different points in the program
    752. 

  752. execution.  Note that once the watchpoint goes out of scope, it is
    753. 

  753. deleted.
    754. 

  754. </p>
    755. 

  755. <div class="smallexample">
    756. 

  756. <pre class="smallexample">(gdb)
    757. 

  757. -break-watch C
    758. 

  758. ^done,wpt={number=&quot;2&quot;,exp=&quot;C&quot;}
    759. 

  759. (gdb)
    760. 

  760. -break-list
    761. 

  761. ^done,BreakpointTable={nr_rows=&quot;2&quot;,nr_cols=&quot;6&quot;,
    762. 

  762. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    763. 

  763. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    764. 

  764. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    765. 

  765. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    766. 

  766. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    767. 

  767. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    768. 

  768. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    769. 

  769. addr=&quot;0x00010734&quot;,func=&quot;callee4&quot;,
    770. 

  770. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    771. 

  771. fullname=&quot;/home/foo/devo/gdb/testsuite/gdb.mi/basics.c&quot;line=&quot;8&quot;,thread-groups=[&quot;i1&quot;],
    772. 

  772. times=&quot;1&quot;},
    773. 

  773. bkpt={number=&quot;2&quot;,type=&quot;watchpoint&quot;,disp=&quot;keep&quot;,
    774. 

  774. enabled=&quot;y&quot;,addr=&quot;&quot;,what=&quot;C&quot;,thread-groups=[&quot;i1&quot;],times=&quot;0&quot;}]}
    775. 

  775. (gdb)
    776. 

  776. -exec-continue
    777. 

  777. ^running
    778. 

  778. (gdb)
    779. 

  779. *stopped,reason=&quot;watchpoint-trigger&quot;,wpt={number=&quot;2&quot;,exp=&quot;C&quot;},
    780. 

  780. value={old=&quot;-276895068&quot;,new=&quot;3&quot;},
    781. 

  781. frame={func=&quot;callee4&quot;,args=[],
    782. 

  782. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    783. 

  783. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;13&quot;,
    784. 

  784. arch=&quot;i386:x86_64&quot;}
    785. 

  785. (gdb)
    786. 

  786. -break-list
    787. 

  787. ^done,BreakpointTable={nr_rows=&quot;2&quot;,nr_cols=&quot;6&quot;,
    788. 

  788. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    789. 

  789. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    790. 

  790. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    791. 

  791. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    792. 

  792. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    793. 

  793. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    794. 

  794. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    795. 

  795. addr=&quot;0x00010734&quot;,func=&quot;callee4&quot;,
    796. 

  796. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    797. 

  797. fullname=&quot;/home/foo/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;8&quot;,thread-groups=[&quot;i1&quot;],
    798. 

  798. times=&quot;1&quot;},
    799. 

  799. bkpt={number=&quot;2&quot;,type=&quot;watchpoint&quot;,disp=&quot;keep&quot;,
    800. 

  800. enabled=&quot;y&quot;,addr=&quot;&quot;,what=&quot;C&quot;,thread-groups=[&quot;i1&quot;],times=&quot;-5&quot;}]}
    801. 

  801. (gdb)
    802. 

  802. -exec-continue
    803. 

  803. ^running
    804. 

  804. ^done,reason=&quot;watchpoint-scope&quot;,wpnum=&quot;2&quot;,
    805. 

  805. frame={func=&quot;callee3&quot;,args=[{name=&quot;strarg&quot;,
    806. 

  806. value=&quot;0x11940 \&quot;A string argument.\&quot;&quot;}],
    807. 

  807. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    808. 

  808. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;18&quot;,
    809. 

  809. arch=&quot;i386:x86_64&quot;}
    810. 

  810. (gdb)
    811. 

  811. -break-list
    812. 

  812. ^done,BreakpointTable={nr_rows=&quot;1&quot;,nr_cols=&quot;6&quot;,
    813. 

  813. hdr=[{width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;number&quot;,colhdr=&quot;Num&quot;},
    814. 

  814. {width=&quot;14&quot;,alignment=&quot;-1&quot;,col_name=&quot;type&quot;,colhdr=&quot;Type&quot;},
    815. 

  815. {width=&quot;4&quot;,alignment=&quot;-1&quot;,col_name=&quot;disp&quot;,colhdr=&quot;Disp&quot;},
    816. 

  816. {width=&quot;3&quot;,alignment=&quot;-1&quot;,col_name=&quot;enabled&quot;,colhdr=&quot;Enb&quot;},
    817. 

  817. {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;addr&quot;,colhdr=&quot;Address&quot;},
    818. 

  818. {width=&quot;40&quot;,alignment=&quot;2&quot;,col_name=&quot;what&quot;,colhdr=&quot;What&quot;}],
    819. 

  819. body=[bkpt={number=&quot;1&quot;,type=&quot;breakpoint&quot;,disp=&quot;keep&quot;,enabled=&quot;y&quot;,
    820. 

  820. addr=&quot;0x00010734&quot;,func=&quot;callee4&quot;,
    821. 

  821. file=&quot;../../../devo/gdb/testsuite/gdb.mi/basics.c&quot;,
    822. 

  822. fullname=&quot;/home/foo/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;8&quot;,
    823. 

  823. thread-groups=[&quot;i1&quot;],times=&quot;1&quot;}]}
    824. 

  824. (gdb)
    825. 

  825. </pre></div>
    826. 

  826. 

  827. 

  828. <hr>
    829. 

  829. <div class="header">
    830. 

  830. <p>
    831. 

  831. Next: <a href="GDB_002fMI-Catchpoint-Commands.html#GDB_002fMI-Catchpoint-Commands" accesskey="n" rel="next">GDB/MI Catchpoint Commands</a>, Previous: <a href="GDB_002fMI-Command-Description-Format.html#GDB_002fMI-Command-Description-Format" accesskey="p" rel="previous">GDB/MI Command Description Format</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>
    832. 

  832. </div>
    833. 

  833. 

  834. 

  835. 

  836. </body>
    837. 

  837. </html>
    838.