### 23.2 Scripting gdb using Python

You can script gdb using the Python programming language. This feature is available only if gdb was configured using `--with-python`.

Python scripts used by gdb should be installed in `data-directory/python`, where data-directory is the data directory as determined at gdb startup (see Data Files). This directory, known as the python directory, is automatically added to the Python Search Path in order to allow the Python interpreter to locate all scripts installed at this location.

Additionally, gdb commands and convenience functions which are written in Python and are located in the `data-directory/python/gdb/command` or `data-directory/python/gdb/function` directories are automatically imported when gdb starts.