23.2.2.17 Accessing frame blocks from Python.

Within each frame, gdb maintains information on each block stored in that frame. These blocks are organized hierarchically, and are represented individually in Python as a gdb.Block. Please see Frames In Python, for a more in-depth discussion on frames. Furthermore, see Examining the Stack, for more detailed technical information on gdb's book-keeping of the stack.

The following block-related functions are available in the gdb module:

A gdb.Block object has the following methods:

— Method on Block: is_valid

Returns True if the gdb.Block object is valid, False if not. A block object can become invalid if the block it refers to doesn't exist anymore in the inferior. All other gdb.Block methods will throw an exception if it is invalid at the time the method is called. This method is also made available to the Python iterator object that gdb.Block provides in an iteration context and via the Python iter built-in function.

A gdb.Block object has the following attributes:

— Instance Variable of Block: start

The start address of the block. This attribute is not writable.

— Instance Variable of Block: end

The end address of the block. This attribute is not writable.

— Instance Variable of Block: function

The name of the block represented as a gdb.Symbol. If the block is not named, then this attribute holds None. This attribute is not writable.

— Instance Variable of Block: superblock

The block containing this block. If this parent block does not exist, this attribute holds None. This attribute is not writable.