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-Symbol-Query.html

599 lines
30KB
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 Symbol Query (Debugging with GDB)</title>

  19. 

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

  21. <meta name="keywords" content="GDB/MI Symbol Query (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-File-Commands.html#GDB_002fMI-File-Commands" rel="next" title="GDB/MI File Commands">

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

  64. <div class="header">

  65. <p>

  66. Next: <a href="GDB_002fMI-File-Commands.html#GDB_002fMI-File-Commands" accesskey="n" rel="next">GDB/MI File Commands</a>, Previous: <a href="GDB_002fMI-Tracepoint-Commands.html#GDB_002fMI-Tracepoint-Commands" accesskey="p" rel="prev">GDB/MI Tracepoint 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="GDB_002fMI-Symbol-Query-Commands"></a>

  70. <h3 class="section">27.18 <small>GDB/MI</small> Symbol Query Commands</h3>

  71. 

  72. 

  73. 

  74. <a name="The-_002dsymbol_002dinfo_002dfunctions-Command"></a>

  75. <h4 class="subheading">The <code>-symbol-info-functions</code> Command</h4>

  76. <a name="index-_002dsymbol_002dinfo_002dfunctions"></a>

  77. <a name="g_t_002dsymbol_002dinfo_002dfunctions"></a>

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

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

  80. 

  81. <div class="smallexample">

  82. <pre class="smallexample"> -symbol-info-functions [--include-nondebug]

  83.                         [--type <var>type_regexp</var>]

  84.                         [--name <var>name_regexp</var>]

  85.                         [--max-results <var>limit</var>]

  86. </pre></div>

  87. 

  88. <p>Return a list containing the names and types for all global functions

  89. taken from the debug information.  The functions are grouped by source

  90. file, and shown with the line number on which each function is

  91. defined.

  92. </p>

  93. <p>The <code>--include-nondebug</code> option causes the output to include

  94. code symbols from the symbol table.

  95. </p>

  96. <p>The options <code>--type</code> and <code>--name</code> allow the symbols returned

  97. to be filtered based on either the name of the function, or the type

  98. signature of the function.

  99. </p>

  100. <p>The option <code>--max-results</code> restricts the command to return no

  101. more than <var>limit</var> results.  If exactly <var>limit</var> results are

  102. returned then there might be additional results available if a higher

  103. limit is used.

  104. </p>

  105. <a name="GDB-Command-62"></a>

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

  107. 

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

  109. </p>

  110. <a name="Example-62"></a>

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

  112. <div class="smallexample">

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

  114. -symbol-info-functions

  115. ^done,symbols=

  116.   {debug=

  117.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  118.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  119.       symbols=[{line=&quot;36&quot;, name=&quot;f4&quot;, type=&quot;void (int *)&quot;,

  120.                 description=&quot;void f4(int *);&quot;},

  121.                {line=&quot;42&quot;, name=&quot;main&quot;, type=&quot;int ()&quot;,

  122.                 description=&quot;int main();&quot;},

  123.                {line=&quot;30&quot;, name=&quot;f1&quot;, type=&quot;my_int_t (int, int)&quot;,

  124.                 description=&quot;static my_int_t f1(int, int);&quot;}]},

  125.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  126.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  127.       symbols=[{line=&quot;33&quot;, name=&quot;f2&quot;, type=&quot;float (another_float_t)&quot;,

  128.                 description=&quot;float f2(another_float_t);&quot;},

  129.                {line=&quot;39&quot;, name=&quot;f3&quot;, type=&quot;int (another_int_t)&quot;,

  130.                 description=&quot;int f3(another_int_t);&quot;},

  131.                {line=&quot;27&quot;, name=&quot;f1&quot;, type=&quot;another_float_t (int)&quot;,

  132.                 description=&quot;static another_float_t f1(int);&quot;}]}]}

  133. </pre><pre class="smallexample">(gdb)

  134. -symbol-info-functions --name f1

  135. ^done,symbols=

  136.   {debug=

  137.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  138.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  139.       symbols=[{line=&quot;30&quot;, name=&quot;f1&quot;, type=&quot;my_int_t (int, int)&quot;,

  140.                 description=&quot;static my_int_t f1(int, int);&quot;}]},

  141.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  142.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  143.       symbols=[{line=&quot;27&quot;, name=&quot;f1&quot;, type=&quot;another_float_t (int)&quot;,

  144.                 description=&quot;static another_float_t f1(int);&quot;}]}]}

  145. </pre><pre class="smallexample">(gdb)

  146. -symbol-info-functions --type void

  147. ^done,symbols=

  148.   {debug=

  149.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  150.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  151.       symbols=[{line=&quot;36&quot;, name=&quot;f4&quot;, type=&quot;void (int *)&quot;,

  152.                 description=&quot;void f4(int *);&quot;}]}]}

  153. </pre><pre class="smallexample">(gdb)

  154. -symbol-info-functions --include-nondebug

  155. ^done,symbols=

  156.   {debug=

  157.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  158.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  159.       symbols=[{line=&quot;36&quot;, name=&quot;f4&quot;, type=&quot;void (int *)&quot;,

  160.                 description=&quot;void f4(int *);&quot;},

  161.                {line=&quot;42&quot;, name=&quot;main&quot;, type=&quot;int ()&quot;,

  162.                 description=&quot;int main();&quot;},

  163.                {line=&quot;30&quot;, name=&quot;f1&quot;, type=&quot;my_int_t (int, int)&quot;,

  164.                 description=&quot;static my_int_t f1(int, int);&quot;}]},

  165.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  166.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  167.       symbols=[{line=&quot;33&quot;, name=&quot;f2&quot;, type=&quot;float (another_float_t)&quot;,

  168.                 description=&quot;float f2(another_float_t);&quot;},

  169.                {line=&quot;39&quot;, name=&quot;f3&quot;, type=&quot;int (another_int_t)&quot;,

  170.                 description=&quot;int f3(another_int_t);&quot;},

  171.                {line=&quot;27&quot;, name=&quot;f1&quot;, type=&quot;another_float_t (int)&quot;,

  172.                 description=&quot;static another_float_t f1(int);&quot;}]}],

  173.    nondebug=

  174.     [{address=&quot;0x0000000000400398&quot;,name=&quot;_init&quot;},

  175.      {address=&quot;0x00000000004003b0&quot;,name=&quot;_start&quot;},

  176.       ...

  177.     ]}

  178. </pre></div>

  179. 

  180. <a name="The-_002dsymbol_002dinfo_002dmodule_002dfunctions-Command"></a>

  181. <h4 class="subheading">The <code>-symbol-info-module-functions</code> Command</h4>

  182. <a name="index-_002dsymbol_002dinfo_002dmodule_002dfunctions"></a>

  183. <a name="g_t_002dsymbol_002dinfo_002dmodule_002dfunctions"></a>

  184. <a name="Synopsis-81"></a>

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

  186. 

  187. <div class="smallexample">

  188. <pre class="smallexample"> -symbol-info-module-functions [--module <var>module_regexp</var>]

  189.                                [--name <var>name_regexp</var>]

  190.                                [--type <var>type_regexp</var>]

  191. </pre></div>

  192. 

  193. <p>Return a list containing the names of all known functions within all

  194. know Fortran modules.  The functions are grouped by source file and

  195. containing module, and shown with the line number on which each

  196. function is defined.

  197. </p>

  198. <p>The option <code>--module</code> only returns results for modules matching

  199. <var>module_regexp</var>.  The option <code>--name</code> only returns functions

  200. whose name matches <var>name_regexp</var>, and <code>--type</code> only returns

  201. functions whose type matches <var>type_regexp</var>.

  202. </p>

  203. <a name="GDB-Command-63"></a>

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

  205. 

  206. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>info module functions</samp>&rsquo;.

  207. </p>

  208. <a name="Example-63"></a>

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

  210. 

  211. <div class="smallexample">

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

  213. -symbol-info-module-functions

  214. ^done,symbols=

  215.   [{module=&quot;mod1&quot;,

  216.     files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  217.             fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  218.             symbols=[{line=&quot;21&quot;,name=&quot;mod1::check_all&quot;,type=&quot;void (void)&quot;,

  219.                       description=&quot;void mod1::check_all(void);&quot;}]}]},

  220.     {module=&quot;mod2&quot;,

  221.      files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  222.              fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  223.              symbols=[{line=&quot;30&quot;,name=&quot;mod2::check_var_i&quot;,type=&quot;void (void)&quot;,

  224.                        description=&quot;void mod2::check_var_i(void);&quot;}]}]},

  225.     {module=&quot;mod3&quot;,

  226.      files=[{filename=&quot;/projec/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  227.              fullname=&quot;/projec/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  228.              symbols=[{line=&quot;21&quot;,name=&quot;mod3::check_all&quot;,type=&quot;void (void)&quot;,

  229.                        description=&quot;void mod3::check_all(void);&quot;},

  230.                       {line=&quot;27&quot;,name=&quot;mod3::check_mod2&quot;,type=&quot;void (void)&quot;,

  231.                        description=&quot;void mod3::check_mod2(void);&quot;}]}]},

  232.     {module=&quot;modmany&quot;,

  233.      files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  234.              fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  235.              symbols=[{line=&quot;35&quot;,name=&quot;modmany::check_some&quot;,type=&quot;void (void)&quot;,

  236.                        description=&quot;void modmany::check_some(void);&quot;}]}]},

  237.     {module=&quot;moduse&quot;,

  238.      files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  239.              fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  240.              symbols=[{line=&quot;44&quot;,name=&quot;moduse::check_all&quot;,type=&quot;void (void)&quot;,

  241.                        description=&quot;void moduse::check_all(void);&quot;},

  242.                       {line=&quot;49&quot;,name=&quot;moduse::check_var_x&quot;,type=&quot;void (void)&quot;,

  243.                        description=&quot;void moduse::check_var_x(void);&quot;}]}]}]

  244. </pre></div>

  245. 

  246. <a name="The-_002dsymbol_002dinfo_002dmodule_002dvariables-Command"></a>

  247. <h4 class="subheading">The <code>-symbol-info-module-variables</code> Command</h4>

  248. <a name="index-_002dsymbol_002dinfo_002dmodule_002dvariables"></a>

  249. <a name="g_t_002dsymbol_002dinfo_002dmodule_002dvariables"></a>

  250. <a name="Synopsis-82"></a>

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

  252. 

  253. <div class="smallexample">

  254. <pre class="smallexample"> -symbol-info-module-variables [--module <var>module_regexp</var>]

  255.                                [--name <var>name_regexp</var>]

  256.                                [--type <var>type_regexp</var>]

  257. </pre></div>

  258. 

  259. <p>Return a list containing the names of all known variables within all

  260. know Fortran modules.  The variables are grouped by source file and

  261. containing module, and shown with the line number on which each

  262. variable is defined.

  263. </p>

  264. <p>The option <code>--module</code> only returns results for modules matching

  265. <var>module_regexp</var>.  The option <code>--name</code> only returns variables

  266. whose name matches <var>name_regexp</var>, and <code>--type</code> only returns

  267. variables whose type matches <var>type_regexp</var>.

  268. </p>

  269. <a name="GDB-Command-64"></a>

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

  271. 

  272. <p>The corresponding <small>GDB</small> command is &lsquo;<samp>info module variables</samp>&rsquo;.

  273. </p>

  274. <a name="Example-64"></a>

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

  276. 

  277. <div class="smallexample">

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

  279. -symbol-info-module-variables

  280. ^done,symbols=

  281.   [{module=&quot;mod1&quot;,

  282.     files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  283.             fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  284.             symbols=[{line=&quot;18&quot;,name=&quot;mod1::var_const&quot;,type=&quot;integer(kind=4)&quot;,

  285.                       description=&quot;integer(kind=4) mod1::var_const;&quot;},

  286.                      {line=&quot;17&quot;,name=&quot;mod1::var_i&quot;,type=&quot;integer(kind=4)&quot;,

  287.                       description=&quot;integer(kind=4) mod1::var_i;&quot;}]}]},

  288.    {module=&quot;mod2&quot;,

  289.     files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  290.             fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  291.             symbols=[{line=&quot;28&quot;,name=&quot;mod2::var_i&quot;,type=&quot;integer(kind=4)&quot;,

  292.                       description=&quot;integer(kind=4) mod2::var_i;&quot;}]}]},

  293.    {module=&quot;mod3&quot;,

  294.     files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  295.             fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  296.             symbols=[{line=&quot;18&quot;,name=&quot;mod3::mod1&quot;,type=&quot;integer(kind=4)&quot;,

  297.                       description=&quot;integer(kind=4) mod3::mod1;&quot;},

  298.                      {line=&quot;17&quot;,name=&quot;mod3::mod2&quot;,type=&quot;integer(kind=4)&quot;,

  299.                       description=&quot;integer(kind=4) mod3::mod2;&quot;},

  300.                      {line=&quot;19&quot;,name=&quot;mod3::var_i&quot;,type=&quot;integer(kind=4)&quot;,

  301.                       description=&quot;integer(kind=4) mod3::var_i;&quot;}]}]},

  302.    {module=&quot;modmany&quot;,

  303.     files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  304.             fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  305.             symbols=[{line=&quot;33&quot;,name=&quot;modmany::var_a&quot;,type=&quot;integer(kind=4)&quot;,

  306.                       description=&quot;integer(kind=4) modmany::var_a;&quot;},

  307.                      {line=&quot;33&quot;,name=&quot;modmany::var_b&quot;,type=&quot;integer(kind=4)&quot;,

  308.                       description=&quot;integer(kind=4) modmany::var_b;&quot;},

  309.                      {line=&quot;33&quot;,name=&quot;modmany::var_c&quot;,type=&quot;integer(kind=4)&quot;,

  310.                       description=&quot;integer(kind=4) modmany::var_c;&quot;},

  311.                      {line=&quot;33&quot;,name=&quot;modmany::var_i&quot;,type=&quot;integer(kind=4)&quot;,

  312.                       description=&quot;integer(kind=4) modmany::var_i;&quot;}]}]},

  313.    {module=&quot;moduse&quot;,

  314.     files=[{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  315.             fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  316.             symbols=[{line=&quot;42&quot;,name=&quot;moduse::var_x&quot;,type=&quot;integer(kind=4)&quot;,

  317.                       description=&quot;integer(kind=4) moduse::var_x;&quot;},

  318.                      {line=&quot;42&quot;,name=&quot;moduse::var_y&quot;,type=&quot;integer(kind=4)&quot;,

  319.                       description=&quot;integer(kind=4) moduse::var_y;&quot;}]}]}]

  320. </pre></div>

  321. 

  322. <a name="The-_002dsymbol_002dinfo_002dmodules-Command"></a>

  323. <h4 class="subheading">The <code>-symbol-info-modules</code> Command</h4>

  324. <a name="index-_002dsymbol_002dinfo_002dmodules"></a>

  325. <a name="g_t_002dsymbol_002dinfo_002dmodules"></a>

  326. <a name="Synopsis-83"></a>

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

  328. 

  329. <div class="smallexample">

  330. <pre class="smallexample"> -symbol-info-modules [--name <var>name_regexp</var>]

  331.                       [--max-results <var>limit</var>]

  332. 

  333. </pre></div>

  334. 

  335. <p>Return a list containing the names of all known Fortran modules.  The

  336. modules are grouped by source file, and shown with the line number on

  337. which each modules is defined.

  338. </p>

  339. <p>The option <code>--name</code> allows the modules returned to be filtered

  340. based the name of the module.

  341. </p>

  342. <p>The option <code>--max-results</code> restricts the command to return no

  343. more than <var>limit</var> results.  If exactly <var>limit</var> results are

  344. returned then there might be additional results available if a higher

  345. limit is used.

  346. </p>

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

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

  349. 

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

  351. </p>

  352. <a name="Example-65"></a>

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

  354. <div class="smallexample">

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

  356. -symbol-info-modules

  357. ^done,symbols=

  358.   {debug=

  359.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  360.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  361.       symbols=[{line=&quot;16&quot;,name=&quot;mod1&quot;},

  362.                {line=&quot;22&quot;,name=&quot;mod2&quot;}]},

  363.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  364.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  365.       symbols=[{line=&quot;16&quot;,name=&quot;mod3&quot;},

  366.                {line=&quot;22&quot;,name=&quot;modmany&quot;},

  367.                {line=&quot;26&quot;,name=&quot;moduse&quot;}]}]}

  368. </pre><pre class="smallexample">(gdb)

  369. -symbol-info-modules --name mod[123]

  370. ^done,symbols=

  371.   {debug=

  372.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  373.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules-2.f90&quot;,

  374.       symbols=[{line=&quot;16&quot;,name=&quot;mod1&quot;},

  375.                {line=&quot;22&quot;,name=&quot;mod2&quot;}]},

  376.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  377.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-fortran-modules.f90&quot;,

  378.       symbols=[{line=&quot;16&quot;,name=&quot;mod3&quot;}]}]}

  379. </pre></div>

  380. 

  381. <a name="The-_002dsymbol_002dinfo_002dtypes-Command"></a>

  382. <h4 class="subheading">The <code>-symbol-info-types</code> Command</h4>

  383. <a name="index-_002dsymbol_002dinfo_002dtypes"></a>

  384. <a name="g_t_002dsymbol_002dinfo_002dtypes"></a>

  385. <a name="Synopsis-84"></a>

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

  387. 

  388. <div class="smallexample">

  389. <pre class="smallexample"> -symbol-info-types [--name <var>name_regexp</var>]

  390.                     [--max-results <var>limit</var>]

  391. 

  392. </pre></div>

  393. 

  394. <p>Return a list of all defined types.  The types are grouped by source

  395. file, and shown with the line number on which each user defined type

  396. is defined.  Some base types are not defined in the source code but

  397. are added to the debug information by the compiler, for example

  398. <code>int</code>, <code>float</code>, etc.; these types do not have an associated

  399. line number.

  400. </p>

  401. <p>The option <code>--name</code> allows the list of types returned to be

  402. filtered by name.

  403. </p>

  404. <p>The option <code>--max-results</code> restricts the command to return no

  405. more than <var>limit</var> results.  If exactly <var>limit</var> results are

  406. returned then there might be additional results available if a higher

  407. limit is used.

  408. </p>

  409. <a name="GDB-Command-66"></a>

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

  411. 

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

  413. </p>

  414. <a name="Example-66"></a>

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

  416. <div class="smallexample">

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

  418. -symbol-info-types

  419. ^done,symbols=

  420.   {debug=

  421.      [{filename=&quot;gdb.mi/mi-sym-info-1.c&quot;,

  422.        fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  423.        symbols=[{name=&quot;float&quot;},

  424.                 {name=&quot;int&quot;},

  425.                 {line=&quot;27&quot;,name=&quot;typedef int my_int_t;&quot;}]},

  426.       {filename=&quot;gdb.mi/mi-sym-info-2.c&quot;,

  427.        fullname=&quot;/project/gdb.mi/mi-sym-info-2.c&quot;,

  428.        symbols=[{line=&quot;24&quot;,name=&quot;typedef float another_float_t;&quot;},

  429.                 {line=&quot;23&quot;,name=&quot;typedef int another_int_t;&quot;},

  430.                 {name=&quot;float&quot;},

  431.                 {name=&quot;int&quot;}]}]}

  432. </pre><pre class="smallexample">(gdb)

  433. -symbol-info-types --name _int_

  434. ^done,symbols=

  435.   {debug=

  436.      [{filename=&quot;gdb.mi/mi-sym-info-1.c&quot;,

  437.        fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  438.        symbols=[{line=&quot;27&quot;,name=&quot;typedef int my_int_t;&quot;}]},

  439.       {filename=&quot;gdb.mi/mi-sym-info-2.c&quot;,

  440.        fullname=&quot;/project/gdb.mi/mi-sym-info-2.c&quot;,

  441.        symbols=[{line=&quot;23&quot;,name=&quot;typedef int another_int_t;&quot;}]}]}

  442. </pre></div>

  443. 

  444. <a name="The-_002dsymbol_002dinfo_002dvariables-Command"></a>

  445. <h4 class="subheading">The <code>-symbol-info-variables</code> Command</h4>

  446. <a name="index-_002dsymbol_002dinfo_002dvariables"></a>

  447. <a name="g_t_002dsymbol_002dinfo_002dvariables"></a>

  448. <a name="Synopsis-85"></a>

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

  450. 

  451. <div class="smallexample">

  452. <pre class="smallexample"> -symbol-info-variables [--include-nondebug]

  453.                         [--type <var>type_regexp</var>]

  454.                         [--name <var>name_regexp</var>]

  455.                         [--max-results <var>limit</var>]

  456. 

  457. </pre></div>

  458. 

  459. <p>Return a list containing the names and types for all global variables

  460. taken from the debug information.  The variables are grouped by source

  461. file, and shown with the line number on which each variable is

  462. defined.

  463. </p>

  464. <p>The <code>--include-nondebug</code> option causes the output to include

  465. data symbols from the symbol table.

  466. </p>

  467. <p>The options <code>--type</code> and <code>--name</code> allow the symbols returned

  468. to be filtered based on either the name of the variable, or the type

  469. of the variable.

  470. </p>

  471. <p>The option <code>--max-results</code> restricts the command to return no

  472. more than <var>limit</var> results.  If exactly <var>limit</var> results are

  473. returned then there might be additional results available if a higher

  474. limit is used.

  475. </p>

  476. <a name="GDB-Command-67"></a>

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

  478. 

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

  480. </p>

  481. <a name="Example-67"></a>

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

  483. <div class="smallexample">

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

  485. -symbol-info-variables

  486. ^done,symbols=

  487.   {debug=

  488.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  489.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  490.       symbols=[{line=&quot;25&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  491.                 description=&quot;static float global_f1;&quot;},

  492.                {line=&quot;24&quot;,name=&quot;global_i1&quot;,type=&quot;int&quot;,

  493.                 description=&quot;static int global_i1;&quot;}]},

  494.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  495.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  496.       symbols=[{line=&quot;21&quot;,name=&quot;global_f2&quot;,type=&quot;int&quot;,

  497.                 description=&quot;int global_f2;&quot;},

  498.                {line=&quot;20&quot;,name=&quot;global_i2&quot;,type=&quot;int&quot;,

  499.                 description=&quot;int global_i2;&quot;},

  500.                {line=&quot;19&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  501.                 description=&quot;static float global_f1;&quot;},

  502.                {line=&quot;18&quot;,name=&quot;global_i1&quot;,type=&quot;int&quot;,

  503.                 description=&quot;static int global_i1;&quot;}]}]}

  504. </pre><pre class="smallexample">(gdb)

  505. -symbol-info-variables --name f1

  506. ^done,symbols=

  507.   {debug=

  508.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  509.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  510.       symbols=[{line=&quot;25&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  511.                 description=&quot;static float global_f1;&quot;}]},

  512.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  513.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  514.       symbols=[{line=&quot;19&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  515.                 description=&quot;static float global_f1;&quot;}]}]}

  516. </pre><pre class="smallexample">(gdb)

  517. -symbol-info-variables --type float

  518. ^done,symbols=

  519.   {debug=

  520.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  521.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  522.       symbols=[{line=&quot;25&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  523.                 description=&quot;static float global_f1;&quot;}]},

  524.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  525.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  526.       symbols=[{line=&quot;19&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  527.                 description=&quot;static float global_f1;&quot;}]}]}

  528. </pre><pre class="smallexample">(gdb)

  529. -symbol-info-variables --include-nondebug

  530. ^done,symbols=

  531.   {debug=

  532.     [{filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  533.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-1.c&quot;,

  534.       symbols=[{line=&quot;25&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  535.                 description=&quot;static float global_f1;&quot;},

  536.                {line=&quot;24&quot;,name=&quot;global_i1&quot;,type=&quot;int&quot;,

  537.                 description=&quot;static int global_i1;&quot;}]},

  538.      {filename=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  539.       fullname=&quot;/project/gdb/testsuite/gdb.mi/mi-sym-info-2.c&quot;,

  540.       symbols=[{line=&quot;21&quot;,name=&quot;global_f2&quot;,type=&quot;int&quot;,

  541.                 description=&quot;int global_f2;&quot;},

  542.                {line=&quot;20&quot;,name=&quot;global_i2&quot;,type=&quot;int&quot;,

  543.                 description=&quot;int global_i2;&quot;},

  544.                {line=&quot;19&quot;,name=&quot;global_f1&quot;,type=&quot;float&quot;,

  545.                 description=&quot;static float global_f1;&quot;},

  546.                {line=&quot;18&quot;,name=&quot;global_i1&quot;,type=&quot;int&quot;,

  547.                 description=&quot;static int global_i1;&quot;}]}],

  548.    nondebug=

  549.     [{address=&quot;0x00000000004005d0&quot;,name=&quot;_IO_stdin_used&quot;},

  550.      {address=&quot;0x00000000004005d8&quot;,name=&quot;__dso_handle&quot;}

  551.       ...

  552.     ]}

  553. </pre></div>

  554. 

  555. 

  556. 

  557. <a name="The-_002dsymbol_002dlist_002dlines-Command"></a>

  558. <h4 class="subheading">The <code>-symbol-list-lines</code> Command</h4>

  559. <a name="index-_002dsymbol_002dlist_002dlines"></a>

  560. 

  561. <a name="Synopsis-86"></a>

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

  563. 

  564. <div class="smallexample">

  565. <pre class="smallexample"> -symbol-list-lines <var>filename</var>

  566. </pre></div>

  567. 

  568. <p>Print the list of lines that contain code and their associated program

  569. addresses for the given source filename.  The entries are sorted in

  570. ascending PC order.

  571. </p>

  572. <a name="GDB-Command-68"></a>

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

  574. 

  575. <p>There is no corresponding <small>GDB</small> command.

  576. </p>

  577. <a name="Example-68"></a>

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

  579. <div class="smallexample">

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

  581. -symbol-list-lines basics.c

  582. ^done,lines=[{pc=&quot;0x08048554&quot;,line=&quot;7&quot;},{pc=&quot;0x0804855a&quot;,line=&quot;8&quot;}]

  583. (gdb)

  584. </pre></div>

  585. 

  586. 

  587. 

  588. 

  589. <hr>

  590. <div class="header">

  591. <p>

  592. Next: <a href="GDB_002fMI-File-Commands.html#GDB_002fMI-File-Commands" accesskey="n" rel="next">GDB/MI File Commands</a>, Previous: <a href="GDB_002fMI-Tracepoint-Commands.html#GDB_002fMI-Tracepoint-Commands" accesskey="p" rel="prev">GDB/MI Tracepoint 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>

  593. </div>

  594. 

  595. 

  596. 

  597. </body>

  598. </html>