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
/
Python-API.html

Python-API.html 12 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166 
  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: Python API</title>
    18. 

  18. 

  19. <meta name="description" content="Debugging with GDB: Python API">
    20. 

  20. <meta name="keywords" content="Debugging with GDB: Python API">
    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="Python.html#Python" rel="up" title="Python">
    29. 

  29. <link href="Basic-Python.html#Basic-Python" rel="next" title="Basic Python">
    30. 

  30. <link href="Python-Commands.html#Python-Commands" rel="previous" title="Python 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="Python-API"></a>
    65. 

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

  66. <p>
    67. 

  67. Next: <a href="Python-Auto_002dloading.html#Python-Auto_002dloading" accesskey="n" rel="next">Python Auto-loading</a>, Previous: <a href="Python-Commands.html#Python-Commands" accesskey="p" rel="previous">Python Commands</a>, Up: <a href="Python.html#Python" accesskey="u" rel="up">Python</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="Python-API-1"></a>
    71. 

  71. <h4 class="subsection">23.2.2 Python API</h4>
    72. 

  72. <a name="index-python-api"></a>
    73. 

  73. <a name="index-programming-in-python"></a>
    74. 

  74. 

  75. <p>You can get quick online help for <small>GDB</small>&rsquo;s Python API by issuing
    76. 

  76. the command <kbd>python&nbsp;help&nbsp;(gdb)</kbd><!-- /@w -->.
    77. 

  77. </p>
    78. 

  78. <p>Functions and methods which have two or more optional arguments allow
    79. 

  79. them to be specified using keyword syntax.  This allows passing some
    80. 

  80. optional arguments while skipping others.  Example:
    81. 

  81. <code><span class="nolinebreak">gdb.some_function</span>&nbsp;('foo',&nbsp;bar&nbsp;=&nbsp;1,&nbsp;baz&nbsp;=&nbsp;2)</code><!-- /@w -->.
    82. 

  82. </p>
    83. 

  83. <table class="menu" border="0" cellspacing="0">
    84. 

  84. <tr><td align="left" valign="top">&bull; <a href="Basic-Python.html#Basic-Python" accesskey="1">Basic Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Basic Python Functions.
    85. 

  85. </td></tr>
    86. 

  86. <tr><td align="left" valign="top">&bull; <a href="Exception-Handling.html#Exception-Handling" accesskey="2">Exception Handling</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How Python exceptions are translated.
    87. 

  87. </td></tr>
    88. 

  88. <tr><td align="left" valign="top">&bull; <a href="Values-From-Inferior.html#Values-From-Inferior" accesskey="3">Values From Inferior</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of values.
    89. 

  89. </td></tr>
    90. 

  90. <tr><td align="left" valign="top">&bull; <a href="Types-In-Python.html#Types-In-Python" accesskey="4">Types In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of types.
    91. 

  91. </td></tr>
    92. 

  92. <tr><td align="left" valign="top">&bull; <a href="Pretty-Printing-API.html#Pretty-Printing-API" accesskey="5">Pretty Printing API</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Pretty-printing values.
    93. 

  93. </td></tr>
    94. 

  94. <tr><td align="left" valign="top">&bull; <a href="Selecting-Pretty_002dPrinters.html#Selecting-Pretty_002dPrinters" accesskey="6">Selecting Pretty-Printers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">How GDB chooses a pretty-printer.
    95. 

  95. </td></tr>
    96. 

  96. <tr><td align="left" valign="top">&bull; <a href="Writing-a-Pretty_002dPrinter.html#Writing-a-Pretty_002dPrinter" accesskey="7">Writing a Pretty-Printer</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Writing a Pretty-Printer.
    97. 

  97. </td></tr>
    98. 

  98. <tr><td align="left" valign="top">&bull; <a href="Type-Printing-API.html#Type-Printing-API" accesskey="8">Type Printing API</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Pretty-printing types.
    99. 

  99. </td></tr>
    100. 

  100. <tr><td align="left" valign="top">&bull; <a href="Frame-Filter-API.html#Frame-Filter-API" accesskey="9">Frame Filter API</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Filtering Frames.
    101. 

  101. </td></tr>
    102. 

  102. <tr><td align="left" valign="top">&bull; <a href="Frame-Decorator-API.html#Frame-Decorator-API">Frame Decorator API</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Decorating Frames.
    103. 

  103. </td></tr>
    104. 

  104. <tr><td align="left" valign="top">&bull; <a href="Writing-a-Frame-Filter.html#Writing-a-Frame-Filter">Writing a Frame Filter</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Writing a Frame Filter.
    105. 

  105. </td></tr>
    106. 

  106. <tr><td align="left" valign="top">&bull; <a href="Unwinding-Frames-in-Python.html#Unwinding-Frames-in-Python">Unwinding Frames in Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Writing frame unwinder.
    107. 

  107. </td></tr>
    108. 

  108. <tr><td align="left" valign="top">&bull; <a href="Xmethods-In-Python.html#Xmethods-In-Python">Xmethods In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Adding and replacing methods of C++ classes.
    109. 

  109. </td></tr>
    110. 

  110. <tr><td align="left" valign="top">&bull; <a href="Xmethod-API.html#Xmethod-API">Xmethod API</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Xmethod types.
    111. 

  111. </td></tr>
    112. 

  112. <tr><td align="left" valign="top">&bull; <a href="Writing-an-Xmethod.html#Writing-an-Xmethod">Writing an Xmethod</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Writing an xmethod.
    113. 

  113. </td></tr>
    114. 

  114. <tr><td align="left" valign="top">&bull; <a href="Inferiors-In-Python.html#Inferiors-In-Python">Inferiors In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of inferiors (processes)
    115. 

  115. </td></tr>
    116. 

  116. <tr><td align="left" valign="top">&bull; <a href="Events-In-Python.html#Events-In-Python">Events In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Listening for events from <small>GDB</small>.
    117. 

  117. </td></tr>
    118. 

  118. <tr><td align="left" valign="top">&bull; <a href="Threads-In-Python.html#Threads-In-Python">Threads In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Accessing inferior threads from Python.
    119. 

  119. </td></tr>
    120. 

  120. <tr><td align="left" valign="top">&bull; <a href="Recordings-In-Python.html#Recordings-In-Python">Recordings In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Accessing recordings from Python.
    121. 

  121. </td></tr>
    122. 

  122. <tr><td align="left" valign="top">&bull; <a href="Commands-In-Python.html#Commands-In-Python">Commands In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Implementing new commands in Python.
    123. 

  123. </td></tr>
    124. 

  124. <tr><td align="left" valign="top">&bull; <a href="Parameters-In-Python.html#Parameters-In-Python">Parameters In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Adding new <small>GDB</small> parameters.
    125. 

  125. </td></tr>
    126. 

  126. <tr><td align="left" valign="top">&bull; <a href="Functions-In-Python.html#Functions-In-Python">Functions In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Writing new convenience functions.
    127. 

  127. </td></tr>
    128. 

  128. <tr><td align="left" valign="top">&bull; <a href="Progspaces-In-Python.html#Progspaces-In-Python">Progspaces In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Program spaces.
    129. 

  129. </td></tr>
    130. 

  130. <tr><td align="left" valign="top">&bull; <a href="Objfiles-In-Python.html#Objfiles-In-Python">Objfiles In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Object files.
    131. 

  131. </td></tr>
    132. 

  132. <tr><td align="left" valign="top">&bull; <a href="Frames-In-Python.html#Frames-In-Python">Frames In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Accessing inferior stack frames from Python.
    133. 

  133. </td></tr>
    134. 

  134. <tr><td align="left" valign="top">&bull; <a href="Blocks-In-Python.html#Blocks-In-Python">Blocks In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Accessing blocks from Python.
    135. 

  135. </td></tr>
    136. 

  136. <tr><td align="left" valign="top">&bull; <a href="Symbols-In-Python.html#Symbols-In-Python">Symbols In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of symbols.
    137. 

  137. </td></tr>
    138. 

  138. <tr><td align="left" valign="top">&bull; <a href="Symbol-Tables-In-Python.html#Symbol-Tables-In-Python">Symbol Tables In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of symbol tables.
    139. 

  139. </td></tr>
    140. 

  140. <tr><td align="left" valign="top">&bull; <a href="Line-Tables-In-Python.html#Line-Tables-In-Python">Line Tables In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of line tables.
    141. 

  141. </td></tr>
    142. 

  142. <tr><td align="left" valign="top">&bull; <a href="Breakpoints-In-Python.html#Breakpoints-In-Python">Breakpoints In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Manipulating breakpoints using Python.
    143. 

  143. </td></tr>
    144. 

  144. <tr><td align="left" valign="top">&bull; <a href="Finish-Breakpoints-in-Python.html#Finish-Breakpoints-in-Python">Finish Breakpoints in Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Setting Breakpoints on function return
    145. 

  145.                                 using Python.
    146. 

  146. </td></tr>
    147. 

  147. <tr><td align="left" valign="top">&bull; <a href="Lazy-Strings-In-Python.html#Lazy-Strings-In-Python">Lazy Strings In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of lazy strings.
    148. 

  148. </td></tr>
    149. 

  149. <tr><td align="left" valign="top">&bull; <a href="Architectures-In-Python.html#Architectures-In-Python">Architectures In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of architectures.
    150. 

  150. </td></tr>
    151. 

  151. <tr><td align="left" valign="top">&bull; <a href="Registers-In-Python.html#Registers-In-Python">Registers In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Python representation of registers.
    152. 

  152. </td></tr>
    153. 

  153. <tr><td align="left" valign="top">&bull; <a href="TUI-Windows-In-Python.html#TUI-Windows-In-Python">TUI Windows In Python</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Implementing new TUI windows.
    154. 

  154. </td></tr>
    155. 

  155. </table>
    156. 

  156. 

  157. <hr>
    158. 

  158. <div class="header">
    159. 

  159. <p>
    160. 

  160. Next: <a href="Python-Auto_002dloading.html#Python-Auto_002dloading" accesskey="n" rel="next">Python Auto-loading</a>, Previous: <a href="Python-Commands.html#Python-Commands" accesskey="p" rel="previous">Python Commands</a>, Up: <a href="Python.html#Python" accesskey="u" rel="up">Python</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>
    161. 

  161. </div>
    162. 

  162. 

  163. 

  164. 

  165. </body>
    166. 

  166. </html>
    167.