Gdb/Architectures-In-Python
From Get docs
Next: Registers In Python, Previous: Lazy Strings In Python, Up: Python API [Contents][Index]
23.2.2.33 Python representation of architectures
GDB uses architecture specific parameters and artifacts in a
number of its various computations. An architecture is represented
by an instance of the gdb.Architecture
class.
A gdb.Architecture
class has the following methods:
- Function
- Architecture.name ()
- Return the name (string value) of the architecture.
- Function
- Architecture.disassemble (
start_pc
[,end_pc
[,count
]]) - Return a list of disassembled instructions starting from the memory address
start_pc
. The optional argumentsend_pc
andcount
determine the number of instructions in the returned list. If both the optional argumentsend_pc
andcount
are specified, then a list of at mostcount
disassembled instructions whose start address falls in the closed memory address interval fromstart_pc
toend_pc
are returned. Ifend_pc
is not specified, butcount
is specified, thencount
number of instructions starting from the addressstart_pc
are returned. Ifcount
is not specified butend_pc
is specified, then all instructions whose start address falls in the closed memory address interval fromstart_pc
toend_pc
are returned. If neitherend_pc
norcount
are specified, then a single instruction atstart_pc
is returned. For all of these cases, each element of the returned list is a Pythondict
with the following string keys:
addr
- The value corresponding to this key is a Python long integer capturing the memory address of the instruction.
asm
- The value corresponding to this key is a string value which represents the instruction with assembly language mnemonics. The assembly language flavor used is the same as that specified by the current CLI variable
disassembly-flavor
. See Machine Code. length
- The value corresponding to this key is the length (integer value) of the instruction in bytes.
- Function
- Architecture.registers ([
reggroup
]) - Return a
gdb.RegisterDescriptorIterator
(see Registers In Python) for all of the registers inreggroup
, a string that is the name of a register group. Ifreggroup
is omitted, or is the empty string, then the register group ‘all
’ is assumed.
- Function
- Architecture.register_groups ()
- Return a
gdb.RegisterGroupsIterator
(see Registers In Python) for all of the register groups available for thegdb.Architecture
.
Next: Registers In Python, Previous: Lazy Strings In Python, Up: Python API [Contents][Index]