23.2.2 Python API

At startup, gdb overrides Python's sys.stdout and sys.stderr to print using gdb's output-paging streams. A Python program which outputs to one of these streams may have its output interrupted by the user (see Screen Size). In this situation, a Python KeyboardInterrupt exception is thrown.

• Basic Python: Basic Python Functions.
• Exception Handling: How Python exceptions are translated.
• Values From Inferior: Python representation of values.
• Types In Python: Python representation of types.
• Pretty Printing API: Pretty-printing values.
• Selecting Pretty-Printers: How GDB chooses a pretty-printer.
• Writing a Pretty-Printer: Writing a Pretty-Printer.
• Inferiors In Python: Python representation of inferiors (processes)
• Events In Python: Listening for events from gdb.
• Threads In Python: Accessing inferior threads from Python.
• Commands In Python: Implementing new commands in Python.
• Parameters In Python: Adding new gdb parameters.
• Functions In Python: Writing new convenience functions.
• Progspaces In Python: Program spaces.
• Objfiles In Python: Object files.
• Frames In Python: Accessing inferior stack frames from Python.
• Blocks In Python: Accessing frame blocks from Python.
• Symbols In Python: Python representation of symbols.
• Symbol Tables In Python: Python representation of symbol tables.
• Lazy Strings In Python: Python representation of lazy strings.
• Breakpoints In Python: Manipulating breakpoints using Python.
• Finish Breakpoints in Python: Setting Breakpoints on function return using Python.