Home Explore Help
Register Sign In
huangmeng
/
asj_pe_project
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: bbf3a35d42
Branches Tags
asj_pe_project
/
tools
/
gcc-arm-10.2-2020.11-x86_64-aarch64-none-linux-gnu
/
share
/
doc
/
gdb
/
GDB_002fMI-Symbol-Query.html

GDB_002fMI-Symbol-Query.html 30 KB
History Raw

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

  2. <html>
    3. 

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

  4. 

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

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

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

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

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

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

  11. 

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

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

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

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

  16. <head>
    17. 

  17. <title>Debugging with GDB: GDB/MI Symbol Query</title>
    18. 

  18. 

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

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

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

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

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

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

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

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

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

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

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

  30. <link href="GDB_002fMI-Tracepoint-Commands.html#GDB_002fMI-Tracepoint-Commands" rel="previous" title="GDB/MI Tracepoint Commands">
    31. 

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

  32. <!--
    33. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  57. -->
    58. 

  58. </style>
    59. 

  59. 

  60. 

  61. </head>
    62. 

  62. 

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

  64. <a name="GDB_002fMI-Symbol-Query"></a>
    65. 

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

  66. <p>
    67. 

  67. 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="previous">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>
    68. 

  68. </div>
    69. 

  69. <hr>
    70. 

  70. <a name="GDB_002fMI-Symbol-Query-Commands"></a>
    71. 

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

  72. 

  73. 

  74. 

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

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

  77. <a name="index-_002dsymbol_002dinfo_002dfunctions"></a>
    78. 

  78. <a name="g_t_002dsymbol_002dinfo_002dfunctions"></a>
    79. 

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

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

  81. 

  82. <div class="smallexample">
    83. 

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

  84.                         [--type <var>type_regexp</var>]
    85. 

  85.                         [--name <var>name_regexp</var>]
    86. 

  86.                         [--max-results <var>limit</var>]
    87. 

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

  88. 

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

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

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

  92. defined.
    93. 

  93. </p>
    94. 

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

  95. code symbols from the symbol table.
    96. 

  96. </p>
    97. 

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

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

  99. signature of the function.
    100. 

  100. </p>
    101. 

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

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

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

  104. limit is used.
    105. 

  105. </p>
    106. 

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

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

  108. 

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

  110. </p>
    111. 

  111. <a name="Example-62"></a>
    112. 

  112. <h4 class="subsubheading">Example</h4>
    113. 

  113. <div class="smallexample">
    114. 

  114. <pre class="smallexample">(gdb)
    115. 

  115. -symbol-info-functions
    116. 

  116. ^done,symbols=
    117. 

  117.   {debug=
    118. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  135. -symbol-info-functions --name f1
    136. 

  136. ^done,symbols=
    137. 

  137.   {debug=
    138. 

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

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

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

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

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

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

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

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

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

  147. -symbol-info-functions --type void
    148. 

  148. ^done,symbols=
    149. 

  149.   {debug=
    150. 

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

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

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

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

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

  155. -symbol-info-functions --include-nondebug
    156. 

  156. ^done,symbols=
    157. 

  157.   {debug=
    158. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  174.    nondebug=
    175. 

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

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

  177.       ...
    178. 

  178.     ]}
    179. 

  179. </pre></div>
    180. 

  180. 

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

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

  183. <a name="index-_002dsymbol_002dinfo_002dmodule_002dfunctions"></a>
    184. 

  184. <a name="g_t_002dsymbol_002dinfo_002dmodule_002dfunctions"></a>
    185. 

  185. <a name="Synopsis-81"></a>
    186. 

  186. <h4 class="subsubheading">Synopsis</h4>
    187. 

  187. 

  188. <div class="smallexample">
    189. 

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

  190.                                [--name <var>name_regexp</var>]
    191. 

  191.                                [--type <var>type_regexp</var>]
    192. 

  192. </pre></div>
    193. 

  193. 

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

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

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

  197. function is defined.
    198. 

  198. </p>
    199. 

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

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

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

  202. functions whose type matches <var>type_regexp</var>.
    203. 

  203. </p>
    204. 

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

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

  206. 

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

  208. </p>
    209. 

  209. <a name="Example-63"></a>
    210. 

  210. <h4 class="subsubheading">Example</h4>
    211. 

  211. 

  212. <div class="smallexample">
    213. 

  213. <pre class="smallexample">(gdb)
    214. 

  214. -symbol-info-module-functions
    215. 

  215. ^done,symbols=
    216. 

  216.   [{module=&quot;mod1&quot;,
    217. 

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

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

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

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

  221.     {module=&quot;mod2&quot;,
    222. 

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

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

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

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

  226.     {module=&quot;mod3&quot;,
    227. 

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

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

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

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

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

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

  233.     {module=&quot;modmany&quot;,
    234. 

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

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

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

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

  238.     {module=&quot;moduse&quot;,
    239. 

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

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

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

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

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

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

  245. </pre></div>
    246. 

  246. 

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

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

  249. <a name="index-_002dsymbol_002dinfo_002dmodule_002dvariables"></a>
    250. 

  250. <a name="g_t_002dsymbol_002dinfo_002dmodule_002dvariables"></a>
    251. 

  251. <a name="Synopsis-82"></a>
    252. 

  252. <h4 class="subsubheading">Synopsis</h4>
    253. 

  253. 

  254. <div class="smallexample">
    255. 

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

  256.                                [--name <var>name_regexp</var>]
    257. 

  257.                                [--type <var>type_regexp</var>]
    258. 

  258. </pre></div>
    259. 

  259. 

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

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

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

  263. variable is defined.
    264. 

  264. </p>
    265. 

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

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

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

  268. variables whose type matches <var>type_regexp</var>.
    269. 

  269. </p>
    270. 

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

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

  272. 

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

  274. </p>
    275. 

  275. <a name="Example-64"></a>
    276. 

  276. <h4 class="subsubheading">Example</h4>
    277. 

  277. 

  278. <div class="smallexample">
    279. 

  279. <pre class="smallexample">(gdb)
    280. 

  280. -symbol-info-module-variables
    281. 

  281. ^done,symbols=
    282. 

  282.   [{module=&quot;mod1&quot;,
    283. 

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

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

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

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

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

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

  289.    {module=&quot;mod2&quot;,
    290. 

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

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

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

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

  294.    {module=&quot;mod3&quot;,
    295. 

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

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

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

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

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

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

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

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

  303.    {module=&quot;modmany&quot;,
    304. 

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

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

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

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

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

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

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

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

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

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

  314.    {module=&quot;moduse&quot;,
    315. 

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

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

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

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

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

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

  321. </pre></div>
    322. 

  322. 

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

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

  325. <a name="index-_002dsymbol_002dinfo_002dmodules"></a>
    326. 

  326. <a name="g_t_002dsymbol_002dinfo_002dmodules"></a>
    327. 

  327. <a name="Synopsis-83"></a>
    328. 

  328. <h4 class="subsubheading">Synopsis</h4>
    329. 

  329. 

  330. <div class="smallexample">
    331. 

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

  332.                       [--max-results <var>limit</var>]
    333. 

  333. 

  334. </pre></div>
    335. 

  335. 

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

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

  338. which each modules is defined.
    339. 

  339. </p>
    340. 

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

  341. based the name of the module.
    342. 

  342. </p>
    343. 

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

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

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

  346. limit is used.
    347. 

  347. </p>
    348. 

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

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

  350. 

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

  352. </p>
    353. 

  353. <a name="Example-65"></a>
    354. 

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

  355. <div class="smallexample">
    356. 

  356. <pre class="smallexample">(gdb)
    357. 

  357. -symbol-info-modules
    358. 

  358. ^done,symbols=
    359. 

  359.   {debug=
    360. 

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

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

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

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

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

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

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

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

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

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

  370. -symbol-info-modules --name mod[123]
    371. 

  371. ^done,symbols=
    372. 

  372.   {debug=
    373. 

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

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

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

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

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

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

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

  380. </pre></div>
    381. 

  381. 

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

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

  384. <a name="index-_002dsymbol_002dinfo_002dtypes"></a>
    385. 

  385. <a name="g_t_002dsymbol_002dinfo_002dtypes"></a>
    386. 

  386. <a name="Synopsis-84"></a>
    387. 

  387. <h4 class="subsubheading">Synopsis</h4>
    388. 

  388. 

  389. <div class="smallexample">
    390. 

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

  391.                     [--max-results <var>limit</var>]
    392. 

  392. 

  393. </pre></div>
    394. 

  394. 

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

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

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

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

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

  400. line number.
    401. 

  401. </p>
    402. 

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

  403. filtered by name.
    404. 

  404. </p>
    405. 

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

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

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

  408. limit is used.
    409. 

  409. </p>
    410. 

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

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

  412. 

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

  414. </p>
    415. 

  415. <a name="Example-66"></a>
    416. 

  416. <h4 class="subsubheading">Example</h4>
    417. 

  417. <div class="smallexample">
    418. 

  418. <pre class="smallexample">(gdb)
    419. 

  419. -symbol-info-types
    420. 

  420. ^done,symbols=
    421. 

  421.   {debug=
    422. 

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

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

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

  425.                 {name=&quot;int&quot;},
    426. 

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

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

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

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

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

  431.                 {name=&quot;float&quot;},
    432. 

  432.                 {name=&quot;int&quot;}]}]}
    433. 

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

  434. -symbol-info-types --name _int_
    435. 

  435. ^done,symbols=
    436. 

  436.   {debug=
    437. 

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

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

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

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

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

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

  443. </pre></div>
    444. 

  444. 

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

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

  447. <a name="index-_002dsymbol_002dinfo_002dvariables"></a>
    448. 

  448. <a name="g_t_002dsymbol_002dinfo_002dvariables"></a>
    449. 

  449. <a name="Synopsis-85"></a>
    450. 

  450. <h4 class="subsubheading">Synopsis</h4>
    451. 

  451. 

  452. <div class="smallexample">
    453. 

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

  454.                         [--type <var>type_regexp</var>]
    455. 

  455.                         [--name <var>name_regexp</var>]
    456. 

  456.                         [--max-results <var>limit</var>]
    457. 

  457. 

  458. </pre></div>
    459. 

  459. 

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

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

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

  463. defined.
    464. 

  464. </p>
    465. 

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

  466. data symbols from the symbol table.
    467. 

  467. </p>
    468. 

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

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

  470. of the variable.
    471. 

  471. </p>
    472. 

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

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

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

  475. limit is used.
    476. 

  476. </p>
    477. 

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

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

  479. 

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

  481. </p>
    482. 

  482. <a name="Example-67"></a>
    483. 

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

  484. <div class="smallexample">
    485. 

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

  486. -symbol-info-variables
    487. 

  487. ^done,symbols=
    488. 

  488.   {debug=
    489. 

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

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

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

  492.                 description=&quot;static float global_f1;&quot;},
    493. 

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

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

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

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

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

  498.                 description=&quot;int global_f2;&quot;},
    499. 

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

  500.                 description=&quot;int global_i2;&quot;},
    501. 

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

  502.                 description=&quot;static float global_f1;&quot;},
    503. 

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

  504.                 description=&quot;static int global_i1;&quot;}]}]}
    505. 

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

  506. -symbol-info-variables --name f1
    507. 

  507. ^done,symbols=
    508. 

  508.   {debug=
    509. 

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

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

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

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

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

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

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

  516.                 description=&quot;static float global_f1;&quot;}]}]}
    517. 

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

  518. -symbol-info-variables --type float
    519. 

  519. ^done,symbols=
    520. 

  520.   {debug=
    521. 

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

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

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

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

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

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

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

  528.                 description=&quot;static float global_f1;&quot;}]}]}
    529. 

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

  530. -symbol-info-variables --include-nondebug
    531. 

  531. ^done,symbols=
    532. 

  532.   {debug=
    533. 

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

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

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

  536.                 description=&quot;static float global_f1;&quot;},
    537. 

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

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

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

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

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

  542.                 description=&quot;int global_f2;&quot;},
    543. 

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

  544.                 description=&quot;int global_i2;&quot;},
    545. 

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

  546.                 description=&quot;static float global_f1;&quot;},
    547. 

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

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

  549.    nondebug=
    550. 

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

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

  552.       ...
    553. 

  553.     ]}
    554. 

  554. </pre></div>
    555. 

  555. 

  556. 

  557. 

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

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

  560. <a name="index-_002dsymbol_002dlist_002dlines"></a>
    561. 

  561. 

  562. <a name="Synopsis-86"></a>
    563. 

  563. <h4 class="subsubheading">Synopsis</h4>
    564. 

  564. 

  565. <div class="smallexample">
    566. 

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

  567. </pre></div>
    568. 

  568. 

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

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

  571. ascending PC order.
    572. 

  572. </p>
    573. 

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

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

  575. 

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

  577. </p>
    578. 

  578. <a name="Example-68"></a>
    579. 

  579. <h4 class="subsubheading">Example</h4>
    580. 

  580. <div class="smallexample">
    581. 

  581. <pre class="smallexample">(gdb)
    582. 

  582. -symbol-list-lines basics.c
    583. 

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

  584. (gdb)
    585. 

  585. </pre></div>
    586. 

  586. 

  587. 

  588. 

  589. 

  590. <hr>
    591. 

  591. <div class="header">
    592. 

  592. <p>
    593. 

  593. 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="previous">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>
    594. 

  594. </div>
    595. 

  595. 

  596. 

  597. 

  598. </body>
    599. 

  599. </html>
    600.