Non-Confidential | ![]() | 101196_0100_03_en | ||
| ||||
Home > Iris APIs > Disassembly API > Disassembling chunks of memory |
Use the disassembler_getDisassembly()
function to disassemble a chunk of memory.
This function returns lines of disassembled instructions. The number of lines that are returned is specified by the count
argument. The amount of memory that a chunk represents depends on the encoding of the instruction set being disassembled. The address of the next instruction following a disassembled chunk is given by the address
field of the last DisassemblyLine
element of the result value. This function returns count
lines, unless an error occurred.
This function can return the following errors:
address
is out of the range minAddr
to maxAddr
for the memory space, it returns E_address_out_of_range
.maxAddr
, which is the end of the memory space, no error is returned. In this case, fewer disassembly lines than requested are returned.opcode
string in DisassemblyLine
must be empty and the disassembly string must have the format "(error: foo
)"
where foo
describes the error that occurred. Disassembly must continue by increasing the address by one unit of the alignment constraint until count
elements are returned.