00001 // Copyright 2007-2008 the V8 project authors. All rights reserved. 00002 // Redistribution and use in source and binary forms, with or without 00003 // modification, are permitted provided that the following conditions are 00004 // met: 00005 // 00006 // * Redistributions of source code must retain the above copyright 00007 // notice, this list of conditions and the following disclaimer. 00008 // * Redistributions in binary form must reproduce the above 00009 // copyright notice, this list of conditions and the following 00010 // disclaimer in the documentation and/or other materials provided 00011 // with the distribution. 00012 // * Neither the name of Google Inc. nor the names of its 00013 // contributors may be used to endorse or promote products derived 00014 // from this software without specific prior written permission. 00015 // 00016 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00017 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00018 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 00019 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 00020 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00021 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00022 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 00023 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 00024 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 00025 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00026 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00027 00028 #ifndef V8_DISASM_H_ 00029 #define V8_DISASM_H_ 00030 00031 namespace disasm { 00032 00033 typedef unsigned char byte; 00034 00035 // Interface and default implementation for converting addresses and 00036 // register-numbers to text. The default implementation is machine 00037 // specific. 00038 class NameConverter { 00039 public: 00040 virtual ~NameConverter() {} 00041 virtual const char* NameOfCPURegister(int reg) const; 00042 virtual const char* NameOfXMMRegister(int reg) const; 00043 virtual const char* NameOfAddress(byte* addr) const; 00044 virtual const char* NameOfConstant(byte* addr) const; 00045 virtual const char* NameInCode(byte* addr) const; 00046 }; 00047 00048 00049 // A generic Disassembler interface 00050 class Disassembler { 00051 public: 00052 // Uses default NameConverter. 00053 Disassembler(); 00054 00055 // Caller deallocates converter. 00056 explicit Disassembler(const NameConverter& converter); 00057 00058 virtual ~Disassembler(); 00059 00060 // Writes one disassembled instruction into 'buffer' (0-terminated). 00061 // Returns the length of the disassembled machine instruction in bytes. 00062 int InstructionDecode(v8::internal::Vector<char> buffer, byte* instruction); 00063 00064 // Returns -1 if instruction does not mark the beginning of a constant pool, 00065 // or the number of entries in the constant pool beginning here. 00066 int ConstantPoolSizeAt(byte* instruction); 00067 00068 // Write disassembly into specified file 'f' using specified NameConverter 00069 // (see constructor). 00070 static void Disassemble(FILE* f, byte* begin, byte* end); 00071 private: 00072 const NameConverter& converter_; 00073 }; 00074 00075 } // namespace disasm 00076 00077 #endif // V8_DISASM_H_