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-Stack-Manipulati...

536 lines
23KB
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 Stack Manipulation (Debugging with GDB)</title>

  19. 

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

  21. <meta name="keywords" content="GDB/MI Stack Manipulation (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-Variable-Objects.html#GDB_002fMI-Variable-Objects" rel="next" title="GDB/MI Variable Objects">

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

  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-Stack-Manipulation"></a>

  64. <div class="header">

  65. <p>

  66. Next: <a href="GDB_002fMI-Variable-Objects.html#GDB_002fMI-Variable-Objects" accesskey="n" rel="next">GDB/MI Variable Objects</a>, Previous: <a href="GDB_002fMI-Program-Execution.html#GDB_002fMI-Program-Execution" accesskey="p" rel="prev">GDB/MI Program Execution</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="GDB_002fMI-Stack-Manipulation-Commands"></a>

  70. <h3 class="section">27.14 <small>GDB/MI</small> Stack Manipulation Commands</h3>

  71. 

  72. <a name="The-_002denable_002dframe_002dfilters-Command"></a>

  73. <h4 class="subheading">The <code>-enable-frame-filters</code> Command</h4>

  74. <a name="index-_002denable_002dframe_002dfilters"></a>

  75. 

  76. <div class="smallexample">

  77. <pre class="smallexample">-enable-frame-filters

  78. </pre></div>

  79. 

  80. <p><small>GDB</small> allows Python-based frame filters to affect the output of

  81. the MI commands relating to stack traces.  As there is no way to

  82. implement this in a fully backward-compatible way, a front end must

  83. request that this functionality be enabled.

  84. </p>

  85. <p>Once enabled, this feature cannot be disabled.

  86. </p>

  87. <p>Note that if Python support has not been compiled into <small>GDB</small>,

  88. this command will still succeed (and do nothing).

  89. </p>

  90. <a name="The-_002dstack_002dinfo_002dframe-Command"></a>

  91. <h4 class="subheading">The <code>-stack-info-frame</code> Command</h4>

  92. <a name="index-_002dstack_002dinfo_002dframe"></a>

  93. 

  94. <a name="Synopsis-41"></a>

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

  96. 

  97. <div class="smallexample">

  98. <pre class="smallexample"> -stack-info-frame

  99. </pre></div>

  100. 

  101. <p>Get info on the selected frame.

  102. </p>

  103. <a name="GDB-Command-40"></a>

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

  105. 

  106. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>info frame</samp>&rsquo; or &lsquo;<samp>frame</samp>&rsquo;

  107. (without arguments).

  108. </p>

  109. <a name="Example-39"></a>

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

  111. 

  112. <div class="smallexample">

  113. <pre class="smallexample">(gdb)

  114. -stack-info-frame

  115. ^done,frame={level=&quot;1&quot;,addr=&quot;0x0001076c&quot;,func=&quot;callee3&quot;,

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

  117. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;17&quot;,

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

  119. (gdb)

  120. </pre></div>

  121. 

  122. <a name="The-_002dstack_002dinfo_002ddepth-Command"></a>

  123. <h4 class="subheading">The <code>-stack-info-depth</code> Command</h4>

  124. <a name="index-_002dstack_002dinfo_002ddepth"></a>

  125. 

  126. <a name="Synopsis-42"></a>

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

  128. 

  129. <div class="smallexample">

  130. <pre class="smallexample"> -stack-info-depth [ <var>max-depth</var> ]

  131. </pre></div>

  132. 

  133. <p>Return the depth of the stack.  If the integer argument <var>max-depth</var>

  134. is specified, do not count beyond <var>max-depth</var> frames.

  135. </p>

  136. <a name="GDB-Command-41"></a>

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

  138. 

  139. <p>There&rsquo;s no equivalent <small>GDB</small> command.

  140. </p>

  141. <a name="Example-40"></a>

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

  143. 

  144. <p>For a stack with frame levels 0 through 11:

  145. </p>

  146. <div class="smallexample">

  147. <pre class="smallexample">(gdb)

  148. -stack-info-depth

  149. ^done,depth=&quot;12&quot;

  150. (gdb)

  151. -stack-info-depth 4

  152. ^done,depth=&quot;4&quot;

  153. (gdb)

  154. -stack-info-depth 12

  155. ^done,depth=&quot;12&quot;

  156. (gdb)

  157. -stack-info-depth 11

  158. ^done,depth=&quot;11&quot;

  159. (gdb)

  160. -stack-info-depth 13

  161. ^done,depth=&quot;12&quot;

  162. (gdb)

  163. </pre></div>

  164. 

  165. <a name="g_t_002dstack_002dlist_002darguments"></a><a name="The-_002dstack_002dlist_002darguments-Command"></a>

  166. <h4 class="subheading">The <code>-stack-list-arguments</code> Command</h4>

  167. <a name="index-_002dstack_002dlist_002darguments"></a>

  168. 

  169. <a name="Synopsis-43"></a>

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

  171. 

  172. <div class="smallexample">

  173. <pre class="smallexample"> -stack-list-arguments [ --no-frame-filters ] [ --skip-unavailable ] <var>print-values</var>

  174.     [ <var>low-frame</var> <var>high-frame</var> ]

  175. </pre></div>

  176. 

  177. <p>Display a list of the arguments for the frames between <var>low-frame</var>

  178. and <var>high-frame</var> (inclusive).  If <var>low-frame</var> and

  179. <var>high-frame</var> are not provided, list the arguments for the whole

  180. call stack.  If the two arguments are equal, show the single frame

  181. at the corresponding level.  It is an error if <var>low-frame</var> is

  182. larger than the actual number of frames.  On the other hand,

  183. <var>high-frame</var> may be larger than the actual number of frames, in

  184. which case only existing frames will be returned.

  185. </p>

  186. <p>If <var>print-values</var> is 0 or <code>--no-values</code>, print only the names of

  187. the variables; if it is 1 or <code>--all-values</code>, print also their

  188. values; and if it is 2 or <code>--simple-values</code>, print the name,

  189. type and value for simple data types, and the name and type for arrays,

  190. structures and unions.  If the option <code>--no-frame-filters</code> is

  191. supplied, then Python frame filters will not be executed.

  192. </p>

  193. <p>If the <code>--skip-unavailable</code> option is specified, arguments that

  194. are not available are not listed.  Partially available arguments

  195. are still displayed, however.

  196. </p>

  197. <p>Use of this command to obtain arguments in a single frame is

  198. deprecated in favor of the &lsquo;<samp>-stack-list-variables</samp>&rsquo; command.

  199. </p>

  200. <a name="GDB-Command-42"></a>

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

  202. 

  203. <p><small>GDB</small> does not have an equivalent command.  <code>gdbtk</code> has a

  204. &lsquo;<samp>gdb_get_args</samp>&rsquo; command which partially overlaps with the

  205. functionality of &lsquo;<samp>-stack-list-arguments</samp>&rsquo;.

  206. </p>

  207. <a name="Example-41"></a>

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

  209. 

  210. <div class="smallexample">

  211. <pre class="smallexample">(gdb)

  212. -stack-list-frames

  213. ^done,

  214. stack=[

  215. frame={level=&quot;0&quot;,addr=&quot;0x00010734&quot;,func=&quot;callee4&quot;,

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

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

  218. arch=&quot;i386:x86_64&quot;},

  219. frame={level=&quot;1&quot;,addr=&quot;0x0001076c&quot;,func=&quot;callee3&quot;,

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

  221. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;17&quot;,

  222. arch=&quot;i386:x86_64&quot;},

  223. frame={level=&quot;2&quot;,addr=&quot;0x0001078c&quot;,func=&quot;callee2&quot;,

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

  225. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;22&quot;,

  226. arch=&quot;i386:x86_64&quot;},

  227. frame={level=&quot;3&quot;,addr=&quot;0x000107b4&quot;,func=&quot;callee1&quot;,

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

  229. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;27&quot;,

  230. arch=&quot;i386:x86_64&quot;},

  231. frame={level=&quot;4&quot;,addr=&quot;0x000107e0&quot;,func=&quot;main&quot;,

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

  233. fullname=&quot;/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c&quot;,line=&quot;32&quot;,

  234. arch=&quot;i386:x86_64&quot;}]

  235. (gdb)

  236. -stack-list-arguments 0

  237. ^done,

  238. stack-args=[

  239. frame={level=&quot;0&quot;,args=[]},

  240. frame={level=&quot;1&quot;,args=[name=&quot;strarg&quot;]},

  241. frame={level=&quot;2&quot;,args=[name=&quot;intarg&quot;,name=&quot;strarg&quot;]},

  242. frame={level=&quot;3&quot;,args=[name=&quot;intarg&quot;,name=&quot;strarg&quot;,name=&quot;fltarg&quot;]},

  243. frame={level=&quot;4&quot;,args=[]}]

  244. (gdb)

  245. -stack-list-arguments 1

  246. ^done,

  247. stack-args=[

  248. frame={level=&quot;0&quot;,args=[]},

  249. frame={level=&quot;1&quot;,

  250.  args=[{name=&quot;strarg&quot;,value=&quot;0x11940 \&quot;A string argument.\&quot;&quot;}]},

  251. frame={level=&quot;2&quot;,args=[

  252. {name=&quot;intarg&quot;,value=&quot;2&quot;},

  253. {name=&quot;strarg&quot;,value=&quot;0x11940 \&quot;A string argument.\&quot;&quot;}]},

  254. {frame={level=&quot;3&quot;,args=[

  255. {name=&quot;intarg&quot;,value=&quot;2&quot;},

  256. {name=&quot;strarg&quot;,value=&quot;0x11940 \&quot;A string argument.\&quot;&quot;},

  257. {name=&quot;fltarg&quot;,value=&quot;3.5&quot;}]},

  258. frame={level=&quot;4&quot;,args=[]}]

  259. (gdb)

  260. -stack-list-arguments 0 2 2

  261. ^done,stack-args=[frame={level=&quot;2&quot;,args=[name=&quot;intarg&quot;,name=&quot;strarg&quot;]}]

  262. (gdb)

  263. -stack-list-arguments 1 2 2

  264. ^done,stack-args=[frame={level=&quot;2&quot;,

  265. args=[{name=&quot;intarg&quot;,value=&quot;2&quot;},

  266. {name=&quot;strarg&quot;,value=&quot;0x11940 \&quot;A string argument.\&quot;&quot;}]}]

  267. (gdb)

  268. </pre></div>

  269. 

  270. 

  271. 

  272. <a name="g_t_002dstack_002dlist_002dframes"></a><a name="The-_002dstack_002dlist_002dframes-Command"></a>

  273. <h4 class="subheading">The <code>-stack-list-frames</code> Command</h4>

  274. <a name="index-_002dstack_002dlist_002dframes"></a>

  275. 

  276. <a name="Synopsis-44"></a>

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

  278. 

  279. <div class="smallexample">

  280. <pre class="smallexample"> -stack-list-frames [ --no-frame-filters <var>low-frame</var> <var>high-frame</var> ]

  281. </pre></div>

  282. 

  283. <p>List the frames currently on the stack.  For each frame it displays the

  284. following info:

  285. </p>

  286. <dl compact="compact">

  287. <dt>&lsquo;<samp><var>level</var></samp>&rsquo;</dt>

  288. <dd><p>The frame number, 0 being the topmost frame, i.e., the innermost function.

  289. </p></dd>

  290. <dt>&lsquo;<samp><var>addr</var></samp>&rsquo;</dt>

  291. <dd><p>The <code>$pc</code> value for that frame.

  292. </p></dd>

  293. <dt>&lsquo;<samp><var>func</var></samp>&rsquo;</dt>

  294. <dd><p>Function name.

  295. </p></dd>

  296. <dt>&lsquo;<samp><var>file</var></samp>&rsquo;</dt>

  297. <dd><p>File name of the source file where the function lives.

  298. </p></dd>

  299. <dt>&lsquo;<samp><var>fullname</var></samp>&rsquo;</dt>

  300. <dd><p>The full file name of the source file where the function lives.

  301. </p></dd>

  302. <dt>&lsquo;<samp><var>line</var></samp>&rsquo;</dt>

  303. <dd><p>Line number corresponding to the <code>$pc</code>.

  304. </p></dd>

  305. <dt>&lsquo;<samp><var>from</var></samp>&rsquo;</dt>

  306. <dd><p>The shared library where this function is defined.  This is only given

  307. if the frame&rsquo;s function is not known.

  308. </p></dd>

  309. <dt>&lsquo;<samp><var>arch</var></samp>&rsquo;</dt>

  310. <dd><p>Frame&rsquo;s architecture.

  311. </p></dd>

  312. </dl>

  313. 

  314. <p>If invoked without arguments, this command prints a backtrace for the

  315. whole stack.  If given two integer arguments, it shows the frames whose

  316. levels are between the two arguments (inclusive).  If the two arguments

  317. are equal, it shows the single frame at the corresponding level.  It is

  318. an error if <var>low-frame</var> is larger than the actual number of

  319. frames.  On the other hand, <var>high-frame</var> may be larger than the

  320. actual number of frames, in which case only existing frames will be

  321. returned.  If the option <code>--no-frame-filters</code> is supplied, then

  322. Python frame filters will not be executed.

  323. </p>

  324. <a name="GDB-Command-43"></a>

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

  326. 

  327. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>backtrace</samp>&rsquo; and &lsquo;<samp>where</samp>&rsquo;.

  328. </p>

  329. <a name="Example-42"></a>

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

  331. 

  332. <p>Full stack backtrace:

  333. </p>

  334. <div class="smallexample">

  335. <pre class="smallexample">(gdb)

  336. -stack-list-frames

  337. ^done,stack=

  338. [frame={level=&quot;0&quot;,addr=&quot;0x0001076c&quot;,func=&quot;foo&quot;,

  339.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;11&quot;,

  340.   arch=&quot;i386:x86_64&quot;},

  341. frame={level=&quot;1&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  342.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  343.   arch=&quot;i386:x86_64&quot;},

  344. frame={level=&quot;2&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  345.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  346.   arch=&quot;i386:x86_64&quot;},

  347. frame={level=&quot;3&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  348.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  349.   arch=&quot;i386:x86_64&quot;},

  350. frame={level=&quot;4&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  351.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  352.   arch=&quot;i386:x86_64&quot;},

  353. frame={level=&quot;5&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  354.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  355.   arch=&quot;i386:x86_64&quot;},

  356. frame={level=&quot;6&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  357.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  358.   arch=&quot;i386:x86_64&quot;},

  359. frame={level=&quot;7&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  360.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  361.   arch=&quot;i386:x86_64&quot;},

  362. frame={level=&quot;8&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  363.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  364.   arch=&quot;i386:x86_64&quot;},

  365. frame={level=&quot;9&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  366.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  367.   arch=&quot;i386:x86_64&quot;},

  368. frame={level=&quot;10&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  369.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  370.   arch=&quot;i386:x86_64&quot;},

  371. frame={level=&quot;11&quot;,addr=&quot;0x00010738&quot;,func=&quot;main&quot;,

  372.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;4&quot;,

  373.   arch=&quot;i386:x86_64&quot;}]

  374. (gdb)

  375. </pre></div>

  376. 

  377. <p>Show frames between <var>low_frame</var> and <var>high_frame</var>:

  378. </p>

  379. <div class="smallexample">

  380. <pre class="smallexample">(gdb)

  381. -stack-list-frames 3 5

  382. ^done,stack=

  383. [frame={level=&quot;3&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  384.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  385.   arch=&quot;i386:x86_64&quot;},

  386. frame={level=&quot;4&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  387.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  388.   arch=&quot;i386:x86_64&quot;},

  389. frame={level=&quot;5&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  390.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  391.   arch=&quot;i386:x86_64&quot;}]

  392. (gdb)

  393. </pre></div>

  394. 

  395. <p>Show a single frame:

  396. </p>

  397. <div class="smallexample">

  398. <pre class="smallexample">(gdb)

  399. -stack-list-frames 3 3

  400. ^done,stack=

  401. [frame={level=&quot;3&quot;,addr=&quot;0x000107a4&quot;,func=&quot;foo&quot;,

  402.   file=&quot;recursive2.c&quot;,fullname=&quot;/home/foo/bar/recursive2.c&quot;,line=&quot;14&quot;,

  403.   arch=&quot;i386:x86_64&quot;}]

  404. (gdb)

  405. </pre></div>

  406. 

  407. 

  408. <a name="The-_002dstack_002dlist_002dlocals-Command"></a>

  409. <h4 class="subheading">The <code>-stack-list-locals</code> Command</h4>

  410. <a name="index-_002dstack_002dlist_002dlocals"></a>

  411. <a name="g_t_002dstack_002dlist_002dlocals"></a>

  412. <a name="Synopsis-45"></a>

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

  414. 

  415. <div class="smallexample">

  416. <pre class="smallexample"> -stack-list-locals [ --no-frame-filters ] [ --skip-unavailable ] <var>print-values</var>

  417. </pre></div>

  418. 

  419. <p>Display the local variable names for the selected frame.  If

  420. <var>print-values</var> is 0 or <code>--no-values</code>, print only the names of

  421. the variables; if it is 1 or <code>--all-values</code>, print also their

  422. values; and if it is 2 or <code>--simple-values</code>, print the name,

  423. type and value for simple data types, and the name and type for arrays,

  424. structures and unions.  In this last case, a frontend can immediately

  425. display the value of simple data types and create variable objects for

  426. other data types when the user wishes to explore their values in

  427. more detail.  If the option <code>--no-frame-filters</code> is supplied, then

  428. Python frame filters will not be executed.

  429. </p>

  430. <p>If the <code>--skip-unavailable</code> option is specified, local variables

  431. that are not available are not listed.  Partially available local

  432. variables are still displayed, however.

  433. </p>

  434. <p>This command is deprecated in favor of the

  435. &lsquo;<samp>-stack-list-variables</samp>&rsquo; command.

  436. </p>

  437. <a name="GDB-Command-44"></a>

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

  439. 

  440. <p>&lsquo;<samp>info locals</samp>&rsquo; in <small>GDB</small>, &lsquo;<samp>gdb_get_locals</samp>&rsquo; in <code>gdbtk</code>.

  441. </p>

  442. <a name="Example-43"></a>

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

  444. 

  445. <div class="smallexample">

  446. <pre class="smallexample">(gdb)

  447. -stack-list-locals 0

  448. ^done,locals=[name=&quot;A&quot;,name=&quot;B&quot;,name=&quot;C&quot;]

  449. (gdb)

  450. -stack-list-locals --all-values

  451. ^done,locals=[{name=&quot;A&quot;,value=&quot;1&quot;},{name=&quot;B&quot;,value=&quot;2&quot;},

  452.   {name=&quot;C&quot;,value=&quot;{1, 2, 3}&quot;}]

  453. -stack-list-locals --simple-values

  454. ^done,locals=[{name=&quot;A&quot;,type=&quot;int&quot;,value=&quot;1&quot;},

  455.   {name=&quot;B&quot;,type=&quot;int&quot;,value=&quot;2&quot;},{name=&quot;C&quot;,type=&quot;int [3]&quot;}]

  456. (gdb)

  457. </pre></div>

  458. 

  459. <a name="g_t_002dstack_002dlist_002dvariables"></a><a name="The-_002dstack_002dlist_002dvariables-Command"></a>

  460. <h4 class="subheading">The <code>-stack-list-variables</code> Command</h4>

  461. <a name="index-_002dstack_002dlist_002dvariables"></a>

  462. 

  463. <a name="Synopsis-46"></a>

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

  465. 

  466. <div class="smallexample">

  467. <pre class="smallexample"> -stack-list-variables [ --no-frame-filters ] [ --skip-unavailable ] <var>print-values</var>

  468. </pre></div>

  469. 

  470. <p>Display the names of local variables and function arguments for the selected frame.  If

  471. <var>print-values</var> is 0 or <code>--no-values</code>, print only the names of

  472. the variables; if it is 1 or <code>--all-values</code>, print also their

  473. values; and if it is 2 or <code>--simple-values</code>, print the name,

  474. type and value for simple data types, and the name and type for arrays,

  475. structures and unions.  If the option <code>--no-frame-filters</code> is

  476. supplied, then Python frame filters will not be executed.

  477. </p>

  478. <p>If the <code>--skip-unavailable</code> option is specified, local variables

  479. and arguments that are not available are not listed.  Partially

  480. available arguments and local variables are still displayed, however.

  481. </p>

  482. <a name="Example-44"></a>

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

  484. 

  485. <div class="smallexample">

  486. <pre class="smallexample">(gdb)

  487. -stack-list-variables --thread 1 --frame 0 --all-values

  488. ^done,variables=[{name=&quot;x&quot;,value=&quot;11&quot;},{name=&quot;s&quot;,value=&quot;{a = 1, b = 2}&quot;}]

  489. (gdb)

  490. </pre></div>

  491. 

  492. 

  493. <a name="The-_002dstack_002dselect_002dframe-Command"></a>

  494. <h4 class="subheading">The <code>-stack-select-frame</code> Command</h4>

  495. <a name="index-_002dstack_002dselect_002dframe"></a>

  496. 

  497. <a name="Synopsis-47"></a>

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

  499. 

  500. <div class="smallexample">

  501. <pre class="smallexample"> -stack-select-frame <var>framenum</var>

  502. </pre></div>

  503. 

  504. <p>Change the selected frame.  Select a different frame <var>framenum</var> on

  505. the stack.

  506. </p>

  507. <p>This command in deprecated in favor of passing the &lsquo;<samp>--frame</samp>&rsquo;

  508. option to every command.

  509. </p>

  510. <a name="GDB-Command-45"></a>

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

  512. 

  513. <p>The corresponding <small>GDB</small> commands are &lsquo;<samp>frame</samp>&rsquo;, &lsquo;<samp>up</samp>&rsquo;,

  514. &lsquo;<samp>down</samp>&rsquo;, &lsquo;<samp>select-frame</samp>&rsquo;, &lsquo;<samp>up-silent</samp>&rsquo;, and &lsquo;<samp>down-silent</samp>&rsquo;.

  515. </p>

  516. <a name="Example-45"></a>

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

  518. 

  519. <div class="smallexample">

  520. <pre class="smallexample">(gdb)

  521. -stack-select-frame 2

  522. ^done

  523. (gdb)

  524. </pre></div>

  525. 

  526. <hr>

  527. <div class="header">

  528. <p>

  529. Next: <a href="GDB_002fMI-Variable-Objects.html#GDB_002fMI-Variable-Objects" accesskey="n" rel="next">GDB/MI Variable Objects</a>, Previous: <a href="GDB_002fMI-Program-Execution.html#GDB_002fMI-Program-Execution" accesskey="p" rel="prev">GDB/MI Program Execution</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>

  530. </div>

  531. 

  532. 

  533. 

  534. </body>

  535. </html>