Description
Disassembler for the x86 architecture.
Most of the useful disassembly methods can be found in the superclass. There's really not much reason to use this class directly or to call any of these methods directly.
Definition at line 22 of file Disassembler/X86.h.
#include <Rose/BinaryAnalysis/Disassembler/X86.h>
Public Types | |
| using | Ptr = X86Ptr |
| Reference counting pointer. More... | |
 Public Types inherited from Rose::BinaryAnalysis::Disassembler::Base | |
| using | Ptr = BasePtr |
Public Member Functions | |
| virtual Base::Ptr | clone () const override |
| Creates a new copy of a disassembler. More... | |
| virtual bool | canDisassemble (SgAsmGenericHeader *) const override |
| Predicate determining the suitability of a disassembler for a specific file header. More... | |
| virtual Unparser::BasePtr | unparser () const override |
| Unparser. More... | |
| virtual SgAsmInstruction * | disassembleOne (const MemoryMap::Ptr &map, rose_addr_t va, AddressSet *successors=nullptr) override |
| This is the lowest level disassembly function and is implemented in the architecture-specific subclasses. More... | |
| virtual SgAsmInstruction * | makeUnknownInstruction (const Exception &) override |
| Makes an unknown instruction from an exception. More... | |
| Public Member Functions inherited from Rose::BinaryAnalysis::Disassembler::Base | |
| size_t | instructionAlignment () const |
| Property: Instruction alignment requirement. More... | |
| virtual RegisterDescriptor | instructionPointerRegister () const |
| Returns the register that points to instructions. More... | |
| virtual RegisterDescriptor | stackPointerRegister () const |
| Returns the register that points to the stack. More... | |
| virtual RegisterDescriptor | stackFrameRegister () const |
| Returns the register that ponts to the stack frame. More... | |
| virtual RegisterDescriptor | stackSegmentRegister () const |
| Returns the segment register for accessing the stack. More... | |
| virtual RegisterDescriptor | callReturnRegister () const |
| Returns the register that holds the return address for a function. More... | |
| const Rose::BinaryAnalysis::InstructionSemantics::BaseSemantics::DispatcherPtr & | dispatcher () const |
| Return an instruction semantics dispatcher if possible. More... | |
| SgAsmInstruction * | disassembleOne (const unsigned char *buf, rose_addr_t buf_va, size_t buf_size, rose_addr_t start_va, AddressSet *successors=NULL) |
| Similar in functionality to the disassembleOne method that takes a MemoryMap argument, except the content buffer is mapped 1:1 to virtual memory beginning at the specified address. More... | |
| void | mark_referenced_instructions (SgAsmInterpretation *, const MemoryMap::Ptr &, const InstructionMap &) |
| Marks parts of the file that correspond to instructions as having been referenced. More... | |
| AddressSet | get_block_successors (const InstructionMap &, bool &complete) |
| Calculates the successor addresses of a basic block and adds them to a successors set. More... | |
| const std::string & | name () const |
| Property: Name by which disassembler is registered. | |
| void | name (const std::string &s) |
| Property: Name by which disassembler is registered. | |
| ByteOrder::Endianness | byteOrder () const |
| Property: Byte order of instructions in memory. | |
| void | byteOrder (ByteOrder::Endianness sex) |
| Property: Byte order of instructions in memory. | |
| size_t | wordSizeBytes () const |
| Property: Basic word size in bytes. | |
| void | wordSizeBytes (size_t nbytes) |
| Property: Basic word size in bytes. | |
| void | registerDictionary (const RegisterDictionaryPtr &rdict) |
| Properties: Register dictionary. More... | |
| RegisterDictionaryPtr | registerDictionary () const |
| Properties: Register dictionary. More... | |
| const CallingConvention::Dictionary & | callingConventions () const |
| Property: Calling convention dictionary. More... | |
| CallingConvention::Dictionary & | callingConventions () |
| Properties: Register dictionary. More... | |
| void | callingConventions (const CallingConvention::Dictionary &d) |
| Properties: Register dictionary. More... | |
| Public Member Functions inherited from Sawyer::SharedObject | |
| SharedObject () | |
| Default constructor. More... | |
| SharedObject (const SharedObject &) | |
| Copy constructor. More... | |
| virtual | ~SharedObject () |
| Virtual destructor. More... | |
| SharedObject & | operator= (const SharedObject &) |
| Assignment. More... | |
Static Public Member Functions | |
| static Ptr | instance (size_t wordSize) |
| Allocating constructor. More... | |
| Static Public Member Functions inherited from Rose::BinaryAnalysis::Disassembler::Base | |
| static SgAsmInstruction * | find_instruction_containing (const InstructionMap &insns, rose_addr_t va) |
| Finds the highest-address instruction that contains the byte at the specified virtual address. More... | |
Protected Member Functions | |
| X86 (size_t wordsize) | |
Additional Inherited Members | |
| Protected Attributes inherited from Rose::BinaryAnalysis::Disassembler::Base | |
| RegisterDictionaryPtr | p_registers |
| Description of registers available for this platform. More... | |
| RegisterDescriptor | REG_IP |
| RegisterDescriptor | REG_SP |
| RegisterDescriptor | REG_SS |
| RegisterDescriptor | REG_SF |
| RegisterDescriptor | REG_LINK |
| Register descriptors initialized during construction. More... | |
| ByteOrder::Endianness | p_byteOrder = ByteOrder::ORDER_LSB |
| Byte order of instructions in memory. More... | |
| size_t | p_wordSizeBytes = 4 |
| Basic word size in bytes. More... | |
| std::string | p_name |
| Name by which this dissassembler is registered. More... | |
| size_t | instructionAlignment_ = 1 |
| Positive alignment constraint for instruction addresses. More... | |
| InstructionSemantics::BaseSemantics::DispatcherPtr | p_proto_dispatcher |
| Prototypical dispatcher for creating real dispatchers. | |
Member Typedef Documentation
Reference counting pointer.
Definition at line 25 of file Disassembler/X86.h.
Member Function Documentation
|
static |
Allocating constructor.
|
overridevirtual |
Creates a new copy of a disassembler.
The new copy has all the same settings as the original.
Thread safety: The thread safety of this virtual method depends on the implementation in the subclass.
Implements Rose::BinaryAnalysis::Disassembler::Base.
|
overridevirtual |
Predicate determining the suitability of a disassembler for a specific file header.
If this disassembler is capable of disassembling machine code described by the specified file header, then this predicate returns true, otherwise it returns false.
Thread safety: The thread safety of this virtual method depends on the implementation in the subclass.
Implements Rose::BinaryAnalysis::Disassembler::Base.
|
overridevirtual |
Returns an unparser suitable for unparsing the same instruction set architecture as recognized and produced by this disassembler.
Implements Rose::BinaryAnalysis::Disassembler::Base.
|
overridevirtual |
This is the lowest level disassembly function and is implemented in the architecture-specific subclasses.
It disassembles one instruction at the specified virtual address. The map is a mapping from virtual addresses to buffer and enables instructions to span file segments that are mapped contiguously in virtual memory by the loader but which might not be contiguous in the file. The instruction's successor virtual addresses are added to the optional successor set (note that successors of an individual instruction can also be obtained via SgAsmInstruction::getSuccessors). If the instruction cannot be disassembled then an exception is thrown and the successors set is not modified.
Thread safety: The safety of this method depends on its implementation in the subclass. In any case, no other thread can be modifying the MemoryMap or successors set at the same time.
Implements Rose::BinaryAnalysis::Disassembler::Base.
|
overridevirtual |
Makes an unknown instruction from an exception.
Thread safety: The safety of this method depends on its implementation in the subclass.
Implements Rose::BinaryAnalysis::Disassembler::Base.
The documentation for this class was generated from the following file:
