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/GDB_002fMI-Miscellaneous-Co...

658 lines
25KB
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>GDB/MI Miscellaneous Commands (Debugging with GDB)</title>

  19. 

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

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

  29. <link href="Annotations.html#Annotations" rel="next" title="Annotations">

  30. <link href="GDB_002fMI-Support-Commands.html#GDB_002fMI-Support-Commands" rel="prev" title="GDB/MI Support 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="GDB_002fMI-Miscellaneous-Commands"></a>

  64. <div class="header">

  65. <p>

  66. Previous: <a href="GDB_002fMI-Support-Commands.html#GDB_002fMI-Support-Commands" accesskey="p" rel="prev">GDB/MI Support Commands</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="Miscellaneous-GDB_002fMI-Commands"></a>

  70. <h3 class="section">27.24 Miscellaneous <small>GDB/MI</small> Commands</h3>

  71. 

  72. 

  73. <a name="The-_002dgdb_002dexit-Command"></a>

  74. <h4 class="subheading">The <code>-gdb-exit</code> Command</h4>

  75. <a name="index-_002dgdb_002dexit"></a>

  76. 

  77. <a name="Synopsis-104"></a>

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

  79. 

  80. <div class="smallexample">

  81. <pre class="smallexample"> -gdb-exit

  82. </pre></div>

  83. 

  84. <p>Exit <small>GDB</small> immediately.

  85. </p>

  86. <a name="GDB-Command-86"></a>

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

  88. 

  89. <p>Approximately corresponds to &lsquo;<samp>quit</samp>&rsquo;.

  90. </p>

  91. <a name="Example-86"></a>

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

  93. 

  94. <div class="smallexample">

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

  96. -gdb-exit

  97. ^exit

  98. </pre></div>

  99. 

  100. 

  101. 

  102. 

  103. <a name="The-_002dgdb_002dset-Command"></a>

  104. <h4 class="subheading">The <code>-gdb-set</code> Command</h4>

  105. <a name="index-_002dgdb_002dset"></a>

  106. 

  107. <a name="Synopsis-105"></a>

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

  109. 

  110. <div class="smallexample">

  111. <pre class="smallexample"> -gdb-set

  112. </pre></div>

  113. 

  114. <p>Set an internal <small>GDB</small> variable.

  115. </p>

  116. <a name="GDB-Command-87"></a>

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

  118. 

  119. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>set</samp>&rsquo;.

  120. </p>

  121. <a name="Example-87"></a>

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

  123. 

  124. <div class="smallexample">

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

  126. -gdb-set $foo=3

  127. ^done

  128. (gdb)

  129. </pre></div>

  130. 

  131. 

  132. <a name="The-_002dgdb_002dshow-Command"></a>

  133. <h4 class="subheading">The <code>-gdb-show</code> Command</h4>

  134. <a name="index-_002dgdb_002dshow"></a>

  135. 

  136. <a name="Synopsis-106"></a>

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

  138. 

  139. <div class="smallexample">

  140. <pre class="smallexample"> -gdb-show

  141. </pre></div>

  142. 

  143. <p>Show the current value of a <small>GDB</small> variable.

  144. </p>

  145. <a name="GDB-Command-88"></a>

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

  147. 

  148. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>show</samp>&rsquo;.

  149. </p>

  150. <a name="Example-88"></a>

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

  152. 

  153. <div class="smallexample">

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

  155. -gdb-show annotate

  156. ^done,value=&quot;0&quot;

  157. (gdb)

  158. </pre></div>

  159. 

  160. 

  161. 

  162. <a name="The-_002dgdb_002dversion-Command"></a>

  163. <h4 class="subheading">The <code>-gdb-version</code> Command</h4>

  164. <a name="index-_002dgdb_002dversion"></a>

  165. 

  166. <a name="Synopsis-107"></a>

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

  168. 

  169. <div class="smallexample">

  170. <pre class="smallexample"> -gdb-version

  171. </pre></div>

  172. 

  173. <p>Show version information for <small>GDB</small>.  Used mostly in testing.

  174. </p>

  175. <a name="GDB-Command-89"></a>

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

  177. 

  178. <p>The <small>GDB</small> equivalent is &lsquo;<samp>show version</samp>&rsquo;.  <small>GDB</small> by

  179. default shows this information when you start an interactive session.

  180. </p>

  181. <a name="Example-89"></a>

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

  183. 

  184. <div class="smallexample">

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

  186. -gdb-version

  187. ~GNU gdb 5.2.1

  188. ~Copyright 2000 Free Software Foundation, Inc.

  189. ~GDB is free software, covered by the GNU General Public License, and

  190. ~you are welcome to change it and/or distribute copies of it under

  191. ~ certain conditions.

  192. ~Type &quot;show copying&quot; to see the conditions.

  193. ~There is absolutely no warranty for GDB.  Type &quot;show warranty&quot; for

  194. ~ details.

  195. ~This GDB was configured as

  196.  &quot;--host=sparc-sun-solaris2.5.1 --target=ppc-eabi&quot;.

  197. ^done

  198. (gdb)

  199. </pre></div>

  200. 

  201. <a name="The-_002dlist_002dthread_002dgroups-Command"></a>

  202. <h4 class="subheading">The <code>-list-thread-groups</code> Command</h4>

  203. <a name="index-_002dlist_002dthread_002dgroups"></a>

  204. 

  205. <a name="Synopsis-108"></a>

  206. <h4 class="subheading">Synopsis</h4>

  207. 

  208. <div class="smallexample">

  209. <pre class="smallexample">-list-thread-groups [ --available ] [ --recurse 1 ] [ <var>group</var> ... ]

  210. </pre></div>

  211. 

  212. <p>Lists thread groups (see <a href="Thread-groups.html#Thread-groups">Thread groups</a>).  When a single thread

  213. group is passed as the argument, lists the children of that group.

  214. When several thread group are passed, lists information about those

  215. thread groups.  Without any parameters, lists information about all

  216. top-level thread groups.

  217. </p>

  218. <p>Normally, thread groups that are being debugged are reported.

  219. With the &lsquo;<samp>--available</samp>&rsquo; option, <small>GDB</small> reports thread groups

  220. available on the target.

  221. </p>

  222. <p>The output of this command may have either a &lsquo;<samp>threads</samp>&rsquo; result or

  223. a &lsquo;<samp>groups</samp>&rsquo; result.  The &lsquo;<samp>thread</samp>&rsquo; result has a list of tuples

  224. as value, with each tuple describing a thread (see <a href="GDB_002fMI-Thread-Information.html#GDB_002fMI-Thread-Information">GDB/MI Thread Information</a>).  The &lsquo;<samp>groups</samp>&rsquo; result has a list of tuples as value,

  225. each tuple describing a thread group.  If top-level groups are

  226. requested (that is, no parameter is passed), or when several groups

  227. are passed, the output always has a &lsquo;<samp>groups</samp>&rsquo; result.  The format

  228. of the &lsquo;<samp>group</samp>&rsquo; result is described below.

  229. </p>

  230. <p>To reduce the number of roundtrips it&rsquo;s possible to list thread groups

  231. together with their children, by passing the &lsquo;<samp>--recurse</samp>&rsquo; option

  232. and the recursion depth.  Presently, only recursion depth of 1 is

  233. permitted.  If this option is present, then every reported thread group

  234. will also include its children, either as &lsquo;<samp>group</samp>&rsquo; or

  235. &lsquo;<samp>threads</samp>&rsquo; field.

  236. </p>

  237. <p>In general, any combination of option and parameters is permitted, with

  238. the following caveats:

  239. </p>

  240. <ul>

  241. <li> When a single thread group is passed, the output will typically

  242. be the &lsquo;<samp>threads</samp>&rsquo; result.  Because threads may not contain

  243. anything, the &lsquo;<samp>recurse</samp>&rsquo; option will be ignored.

  244. 

  245. </li><li> When the &lsquo;<samp>--available</samp>&rsquo; option is passed, limited information may

  246. be available.  In particular, the list of threads of a process might

  247. be inaccessible.  Further, specifying specific thread groups might

  248. not give any performance advantage over listing all thread groups.

  249. The frontend should assume that &lsquo;<samp>-list-thread-groups --available</samp>&rsquo;

  250. is always an expensive operation and cache the results.

  251. 

  252. </li></ul>

  253. 

  254. <p>The &lsquo;<samp>groups</samp>&rsquo; result is a list of tuples, where each tuple may

  255. have the following fields:

  256. </p>

  257. <dl compact="compact">

  258. <dt><code>id</code></dt>

  259. <dd><p>Identifier of the thread group.  This field is always present.

  260. The identifier is an opaque string; frontends should not try to

  261. convert it to an integer, even though it might look like one.

  262. </p>

  263. </dd>

  264. <dt><code>type</code></dt>

  265. <dd><p>The type of the thread group.  At present, only &lsquo;<samp>process</samp>&rsquo; is a

  266. valid type.

  267. </p>

  268. </dd>

  269. <dt><code>pid</code></dt>

  270. <dd><p>The target-specific process identifier.  This field is only present

  271. for thread groups of type &lsquo;<samp>process</samp>&rsquo; and only if the process exists.

  272. </p>

  273. </dd>

  274. <dt><code>exit-code</code></dt>

  275. <dd><p>The exit code of this group&rsquo;s last exited thread, formatted in octal.

  276. This field is only present for thread groups of type &lsquo;<samp>process</samp>&rsquo; and

  277. only if the process is not running.

  278. </p>

  279. </dd>

  280. <dt><code>num_children</code></dt>

  281. <dd><p>The number of children this thread group has.  This field may be

  282. absent for an available thread group.

  283. </p>

  284. </dd>

  285. <dt><code>threads</code></dt>

  286. <dd><p>This field has a list of tuples as value, each tuple describing a

  287. thread.  It may be present if the &lsquo;<samp>--recurse</samp>&rsquo; option is

  288. specified, and it&rsquo;s actually possible to obtain the threads.

  289. </p>

  290. </dd>

  291. <dt><code>cores</code></dt>

  292. <dd><p>This field is a list of integers, each identifying a core that one

  293. thread of the group is running on.  This field may be absent if

  294. such information is not available.

  295. </p>

  296. </dd>

  297. <dt><code>executable</code></dt>

  298. <dd><p>The name of the executable file that corresponds to this thread group.

  299. The field is only present for thread groups of type &lsquo;<samp>process</samp>&rsquo;,

  300. and only if there is a corresponding executable file.

  301. </p>

  302. </dd>

  303. </dl>

  304. 

  305. <a name="Example-90"></a>

  306. <h4 class="subheading">Example</h4>

  307. 

  308. <div class="smallexample">

  309. <pre class="smallexample">gdb

  310. -list-thread-groups

  311. ^done,groups=[{id=&quot;17&quot;,type=&quot;process&quot;,pid=&quot;yyy&quot;,num_children=&quot;2&quot;}]

  312. -list-thread-groups 17

  313. ^done,threads=[{id=&quot;2&quot;,target-id=&quot;Thread 0xb7e14b90 (LWP 21257)&quot;,

  314.    frame={level=&quot;0&quot;,addr=&quot;0xffffe410&quot;,func=&quot;__kernel_vsyscall&quot;,args=[]},state=&quot;running&quot;},

  315. {id=&quot;1&quot;,target-id=&quot;Thread 0xb7e156b0 (LWP 21254)&quot;,

  316.    frame={level=&quot;0&quot;,addr=&quot;0x0804891f&quot;,func=&quot;foo&quot;,args=[{name=&quot;i&quot;,value=&quot;10&quot;}],

  317.            file=&quot;/tmp/a.c&quot;,fullname=&quot;/tmp/a.c&quot;,line=&quot;158&quot;,arch=&quot;i386:x86_64&quot;},state=&quot;running&quot;}]]

  318. -list-thread-groups --available

  319. ^done,groups=[{id=&quot;17&quot;,type=&quot;process&quot;,pid=&quot;yyy&quot;,num_children=&quot;2&quot;,cores=[1,2]}]

  320. -list-thread-groups --available --recurse 1

  321.  ^done,groups=[{id=&quot;17&quot;, types=&quot;process&quot;,pid=&quot;yyy&quot;,num_children=&quot;2&quot;,cores=[1,2],

  322.                 threads=[{id=&quot;1&quot;,target-id=&quot;Thread 0xb7e14b90&quot;,cores=[1]},

  323.                          {id=&quot;2&quot;,target-id=&quot;Thread 0xb7e14b90&quot;,cores=[2]}]},..]

  324. -list-thread-groups --available --recurse 1 17 18

  325. ^done,groups=[{id=&quot;17&quot;, types=&quot;process&quot;,pid=&quot;yyy&quot;,num_children=&quot;2&quot;,cores=[1,2],

  326.                threads=[{id=&quot;1&quot;,target-id=&quot;Thread 0xb7e14b90&quot;,cores=[1]},

  327.                         {id=&quot;2&quot;,target-id=&quot;Thread 0xb7e14b90&quot;,cores=[2]}]},...]

  328. </pre></div>

  329. 

  330. <a name="The-_002dinfo_002dos-Command"></a>

  331. <h4 class="subheading">The <code>-info-os</code> Command</h4>

  332. <a name="index-_002dinfo_002dos"></a>

  333. 

  334. <a name="Synopsis-109"></a>

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

  336. 

  337. <div class="smallexample">

  338. <pre class="smallexample">-info-os [ <var>type</var> ]

  339. </pre></div>

  340. 

  341. <p>If no argument is supplied, the command returns a table of available

  342. operating-system-specific information types.  If one of these types is

  343. supplied as an argument <var>type</var>, then the command returns a table

  344. of data of that type.

  345. </p>

  346. <p>The types of information available depend on the target operating

  347. system.

  348. </p>

  349. <a name="GDB-Command-90"></a>

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

  351. 

  352. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>info os</samp>&rsquo;.

  353. </p>

  354. <a name="Example-91"></a>

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

  356. 

  357. <p>When run on a <small>GNU</small>/Linux system, the output will look something

  358. like this:

  359. </p>

  360. <div class="smallexample">

  361. <pre class="smallexample">gdb

  362. -info-os

  363. ^done,OSDataTable={nr_rows=&quot;10&quot;,nr_cols=&quot;3&quot;,

  364. hdr=[{width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col0&quot;,colhdr=&quot;Type&quot;},

  365.      {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col1&quot;,colhdr=&quot;Description&quot;},

  366.      {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col2&quot;,colhdr=&quot;Title&quot;}],

  367. body=[item={col0=&quot;cpus&quot;,col1=&quot;Listing of all cpus/cores on the system&quot;,

  368.             col2=&quot;CPUs&quot;},

  369.       item={col0=&quot;files&quot;,col1=&quot;Listing of all file descriptors&quot;,

  370.             col2=&quot;File descriptors&quot;},

  371.       item={col0=&quot;modules&quot;,col1=&quot;Listing of all loaded kernel modules&quot;,

  372.             col2=&quot;Kernel modules&quot;},

  373.       item={col0=&quot;msg&quot;,col1=&quot;Listing of all message queues&quot;,

  374.             col2=&quot;Message queues&quot;},

  375.       item={col0=&quot;processes&quot;,col1=&quot;Listing of all processes&quot;,

  376.             col2=&quot;Processes&quot;},

  377.       item={col0=&quot;procgroups&quot;,col1=&quot;Listing of all process groups&quot;,

  378.             col2=&quot;Process groups&quot;},

  379.       item={col0=&quot;semaphores&quot;,col1=&quot;Listing of all semaphores&quot;,

  380.             col2=&quot;Semaphores&quot;},

  381.       item={col0=&quot;shm&quot;,col1=&quot;Listing of all shared-memory regions&quot;,

  382.             col2=&quot;Shared-memory regions&quot;},

  383.       item={col0=&quot;sockets&quot;,col1=&quot;Listing of all internet-domain sockets&quot;,

  384.             col2=&quot;Sockets&quot;},

  385.       item={col0=&quot;threads&quot;,col1=&quot;Listing of all threads&quot;,

  386.             col2=&quot;Threads&quot;}]

  387. gdb

  388. -info-os processes

  389. ^done,OSDataTable={nr_rows=&quot;190&quot;,nr_cols=&quot;4&quot;,

  390. hdr=[{width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col0&quot;,colhdr=&quot;pid&quot;},

  391.      {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col1&quot;,colhdr=&quot;user&quot;},

  392.      {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col2&quot;,colhdr=&quot;command&quot;},

  393.      {width=&quot;10&quot;,alignment=&quot;-1&quot;,col_name=&quot;col3&quot;,colhdr=&quot;cores&quot;}],

  394. body=[item={col0=&quot;1&quot;,col1=&quot;root&quot;,col2=&quot;/sbin/init&quot;,col3=&quot;0&quot;},

  395.       item={col0=&quot;2&quot;,col1=&quot;root&quot;,col2=&quot;[kthreadd]&quot;,col3=&quot;1&quot;},

  396.       item={col0=&quot;3&quot;,col1=&quot;root&quot;,col2=&quot;[ksoftirqd/0]&quot;,col3=&quot;0&quot;},

  397.       ...

  398.       item={col0=&quot;26446&quot;,col1=&quot;stan&quot;,col2=&quot;bash&quot;,col3=&quot;0&quot;},

  399.       item={col0=&quot;28152&quot;,col1=&quot;stan&quot;,col2=&quot;bash&quot;,col3=&quot;1&quot;}]}

  400. (gdb)

  401. </pre></div>

  402. 

  403. <p>(Note that the MI output here includes a <code>&quot;Title&quot;</code> column that

  404. does not appear in command-line <code>info os</code>; this column is useful

  405. for MI clients that want to enumerate the types of data, such as in a

  406. popup menu, but is needless clutter on the command line, and

  407. <code>info os</code> omits it.)

  408. </p>

  409. <a name="The-_002dadd_002dinferior-Command"></a>

  410. <h4 class="subheading">The <code>-add-inferior</code> Command</h4>

  411. <a name="index-_002dadd_002dinferior"></a>

  412. 

  413. <a name="Synopsis-110"></a>

  414. <h4 class="subheading">Synopsis</h4>

  415. 

  416. <div class="smallexample">

  417. <pre class="smallexample">-add-inferior

  418. </pre></div>

  419. 

  420. <p>Creates a new inferior (see <a href="Inferiors-Connections-and-Programs.html#Inferiors-Connections-and-Programs">Inferiors Connections and Programs</a>).  The created

  421. inferior is not associated with any executable.  Such association may

  422. be established with the &lsquo;<samp>-file-exec-and-symbols</samp>&rsquo; command

  423. (see <a href="GDB_002fMI-File-Commands.html#GDB_002fMI-File-Commands">GDB/MI File Commands</a>).  The command response has a single

  424. field, &lsquo;<samp>inferior</samp>&rsquo;, whose value is the identifier of the

  425. thread group corresponding to the new inferior.

  426. </p>

  427. <a name="Example-92"></a>

  428. <h4 class="subheading">Example</h4>

  429. 

  430. <div class="smallexample">

  431. <pre class="smallexample">gdb

  432. -add-inferior

  433. ^done,inferior=&quot;i3&quot;

  434. </pre></div>

  435. 

  436. <a name="The-_002dinterpreter_002dexec-Command"></a>

  437. <h4 class="subheading">The <code>-interpreter-exec</code> Command</h4>

  438. <a name="index-_002dinterpreter_002dexec"></a>

  439. 

  440. <a name="Synopsis-111"></a>

  441. <h4 class="subheading">Synopsis</h4>

  442. 

  443. <div class="smallexample">

  444. <pre class="smallexample">-interpreter-exec <var>interpreter</var> <var>command</var>

  445. </pre></div>

  446. <a name="g_t_002dinterpreter_002dexec"></a>

  447. <p>Execute the specified <var>command</var> in the given <var>interpreter</var>.

  448. </p>

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

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

  451. 

  452. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>interpreter-exec</samp>&rsquo;.

  453. </p>

  454. <a name="Example-93"></a>

  455. <h4 class="subheading">Example</h4>

  456. 

  457. <div class="smallexample">

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

  459. -interpreter-exec console &quot;break main&quot;

  460. &amp;&quot;During symbol reading, couldn't parse type; debugger out of date?.\n&quot;

  461. &amp;&quot;During symbol reading, bad structure-type format.\n&quot;

  462. ~&quot;Breakpoint 1 at 0x8074fc6: file ../../src/gdb/main.c, line 743.\n&quot;

  463. ^done

  464. (gdb)

  465. </pre></div>

  466. 

  467. <a name="The-_002dinferior_002dtty_002dset-Command"></a>

  468. <h4 class="subheading">The <code>-inferior-tty-set</code> Command</h4>

  469. <a name="index-_002dinferior_002dtty_002dset"></a>

  470. 

  471. <a name="Synopsis-112"></a>

  472. <h4 class="subheading">Synopsis</h4>

  473. 

  474. <div class="smallexample">

  475. <pre class="smallexample">-inferior-tty-set /dev/pts/1

  476. </pre></div>

  477. 

  478. <p>Set terminal for future runs of the program being debugged.

  479. </p>

  480. <a name="GDB-Command-92"></a>

  481. <h4 class="subheading"><small>GDB</small> Command</h4>

  482. 

  483. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>set inferior-tty</samp>&rsquo; /dev/pts/1.

  484. </p>

  485. <a name="Example-94"></a>

  486. <h4 class="subheading">Example</h4>

  487. 

  488. <div class="smallexample">

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

  490. -inferior-tty-set /dev/pts/1

  491. ^done

  492. (gdb)

  493. </pre></div>

  494. 

  495. <a name="The-_002dinferior_002dtty_002dshow-Command"></a>

  496. <h4 class="subheading">The <code>-inferior-tty-show</code> Command</h4>

  497. <a name="index-_002dinferior_002dtty_002dshow"></a>

  498. 

  499. <a name="Synopsis-113"></a>

  500. <h4 class="subheading">Synopsis</h4>

  501. 

  502. <div class="smallexample">

  503. <pre class="smallexample">-inferior-tty-show

  504. </pre></div>

  505. 

  506. <p>Show terminal for future runs of program being debugged.

  507. </p>

  508. <a name="GDB-Command-93"></a>

  509. <h4 class="subheading"><small>GDB</small> Command</h4>

  510. 

  511. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>show inferior-tty</samp>&rsquo;.

  512. </p>

  513. <a name="Example-95"></a>

  514. <h4 class="subheading">Example</h4>

  515. 

  516. <div class="smallexample">

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

  518. -inferior-tty-set /dev/pts/1

  519. ^done

  520. (gdb)

  521. -inferior-tty-show

  522. ^done,inferior_tty_terminal=&quot;/dev/pts/1&quot;

  523. (gdb)

  524. </pre></div>

  525. 

  526. <a name="The-_002denable_002dtimings-Command"></a>

  527. <h4 class="subheading">The <code>-enable-timings</code> Command</h4>

  528. <a name="index-_002denable_002dtimings"></a>

  529. 

  530. <a name="Synopsis-114"></a>

  531. <h4 class="subheading">Synopsis</h4>

  532. 

  533. <div class="smallexample">

  534. <pre class="smallexample">-enable-timings [yes | no]

  535. </pre></div>

  536. 

  537. <p>Toggle the printing of the wallclock, user and system times for an MI

  538. command as a field in its output.  This command is to help frontend

  539. developers optimize the performance of their code.  No argument is

  540. equivalent to &lsquo;<samp>yes</samp>&rsquo;.

  541. </p>

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

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

  544. 

  545. <p>No equivalent.

  546. </p>

  547. <a name="Example-96"></a>

  548. <h4 class="subheading">Example</h4>

  549. 

  550. <div class="smallexample">

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

  552. -enable-timings

  553. ^done

  554. (gdb)

  555. -break-insert main

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

  557. addr=&quot;0x080484ed&quot;,func=&quot;main&quot;,file=&quot;myprog.c&quot;,

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

  559. times=&quot;0&quot;},

  560. time={wallclock=&quot;0.05185&quot;,user=&quot;0.00800&quot;,system=&quot;0.00000&quot;}

  561. (gdb)

  562. -enable-timings no

  563. ^done

  564. (gdb)

  565. -exec-run

  566. ^running

  567. (gdb)

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

  569. frame={addr=&quot;0x080484ed&quot;,func=&quot;main&quot;,args=[{name=&quot;argc&quot;,value=&quot;1&quot;},

  570. {name=&quot;argv&quot;,value=&quot;0xbfb60364&quot;}],file=&quot;myprog.c&quot;,

  571. fullname=&quot;/home/nickrob/myprog.c&quot;,line=&quot;73&quot;,arch=&quot;i386:x86_64&quot;}

  572. (gdb)

  573. </pre></div>

  574. 

  575. <a name="The-_002dcomplete-Command"></a>

  576. <h4 class="subheading">The <code>-complete</code> Command</h4>

  577. <a name="index-_002dcomplete"></a>

  578. 

  579. <a name="Synopsis-115"></a>

  580. <h4 class="subheading">Synopsis</h4>

  581. 

  582. <div class="smallexample">

  583. <pre class="smallexample">-complete <var>command</var>

  584. </pre></div>

  585. 

  586. <p>Show a list of completions for partially typed CLI <var>command</var>.

  587. </p>

  588. <p>This command is intended for <small>GDB/MI</small> frontends that cannot use two separate

  589. CLI and MI channels &mdash; for example: because of lack of PTYs like on Windows or

  590. because <small>GDB</small> is used remotely via a SSH connection.

  591. </p>

  592. <a name="Result-9"></a>

  593. <h4 class="subheading">Result</h4>

  594. 

  595. <p>The result consists of two or three fields:

  596. </p>

  597. <dl compact="compact">

  598. <dt>&lsquo;<samp>completion</samp>&rsquo;</dt>

  599. <dd><p>This field contains the completed <var>command</var>.  If <var>command</var>

  600. has no known completions, this field is omitted.

  601. </p>

  602. </dd>

  603. <dt>&lsquo;<samp>matches</samp>&rsquo;</dt>

  604. <dd><p>This field contains a (possibly empty) array of matches.  It is always present.

  605. </p>

  606. </dd>

  607. <dt>&lsquo;<samp>max_completions_reached</samp>&rsquo;</dt>

  608. <dd><p>This field contains <code>1</code> if number of known completions is above

  609. <code>max-completions</code> limit (see <a href="Completion.html#Completion">Completion</a>), otherwise it contains

  610. <code>0</code>.  It is always present.

  611. </p>

  612. </dd>

  613. </dl>

  614. 

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

  616. <h4 class="subheading"><small>GDB</small> Command</h4>

  617. 

  618. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>complete</samp>&rsquo;.

  619. </p>

  620. <a name="Example-97"></a>

  621. <h4 class="subheading">Example</h4>

  622. 

  623. <div class="smallexample">

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

  625. -complete br

  626. ^done,completion=&quot;break&quot;,

  627.       matches=[&quot;break&quot;,&quot;break-range&quot;],

  628.       max_completions_reached=&quot;0&quot;

  629. (gdb)

  630. -complete &quot;b ma&quot;

  631. ^done,completion=&quot;b ma&quot;,

  632.       matches=[&quot;b madvise&quot;,&quot;b main&quot;],max_completions_reached=&quot;0&quot;

  633. (gdb)

  634. -complete &quot;b push_b&quot;

  635. ^done,completion=&quot;b push_back(&quot;,

  636.       matches=[

  637.        &quot;b A::push_back(void*)&quot;,

  638.        &quot;b std::string::push_back(char)&quot;,

  639.        &quot;b std::vector&lt;int, std::allocator&lt;int&gt; &gt;::push_back(int&amp;&amp;)&quot;],

  640.       max_completions_reached=&quot;0&quot;

  641. (gdb)

  642. -complete &quot;nonexist&quot;

  643. ^done,matches=[],max_completions_reached=&quot;0&quot;

  644. (gdb)

  645. 

  646. </pre></div>

  647. 

  648. <hr>

  649. <div class="header">

  650. <p>

  651. Previous: <a href="GDB_002fMI-Support-Commands.html#GDB_002fMI-Support-Commands" accesskey="p" rel="prev">GDB/MI Support Commands</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>

  652. </div>

  653. 

  654. 

  655. 

  656. </body>

  657. </html>