/* * Copyright (C) 2014 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ART_LIBDEXFILE_DEX_DEX_INSTRUCTION_UTILS_H_ #define ART_LIBDEXFILE_DEX_DEX_INSTRUCTION_UTILS_H_ #include "dex_instruction.h" namespace art { // Dex invoke type corresponds to the ordering of INVOKE instructions; // this order is the same for range and non-range invokes. enum DexInvokeType : uint8_t { kDexInvokeVirtual = 0, // invoke-virtual, invoke-virtual-range kDexInvokeSuper, // invoke-super, invoke-super-range kDexInvokeDirect, // invoke-direct, invoke-direct-range kDexInvokeStatic, // invoke-static, invoke-static-range kDexInvokeInterface, // invoke-interface, invoke-interface-range kDexInvokeTypeCount }; // Dex instruction memory access types correspond to the ordering of GET/PUT instructions; // this order is the same for IGET, IPUT, SGET, SPUT, AGET and APUT. enum DexMemAccessType : uint8_t { kDexMemAccessWord = 0, // op 0; int or float, the actual type is not encoded. kDexMemAccessWide, // op_WIDE 1; long or double, the actual type is not encoded. kDexMemAccessObject, // op_OBJECT 2; the actual reference type is not encoded. kDexMemAccessBoolean, // op_BOOLEAN 3 kDexMemAccessByte, // op_BYTE 4 kDexMemAccessChar, // op_CHAR 5 kDexMemAccessShort, // op_SHORT 6 kDexMemAccessTypeCount }; std::ostream& operator<<(std::ostream& os, const DexMemAccessType& type); // NOTE: The following functions disregard quickened instructions. // By "direct" const we mean to exclude const-string and const-class // which load data from somewhere else, i.e. indirectly. constexpr bool IsInstructionDirectConst(Instruction::Code opcode) { return Instruction::CONST_4 <= opcode && opcode <= Instruction::CONST_WIDE_HIGH16; } constexpr bool IsInstructionConstWide(Instruction::Code opcode) { return Instruction::CONST_WIDE_16 <= opcode && opcode <= Instruction::CONST_WIDE_HIGH16; } constexpr bool IsInstructionReturn(Instruction::Code opcode) { return Instruction::RETURN_VOID <= opcode && opcode <= Instruction::RETURN_OBJECT; } constexpr bool IsInstructionInvoke(Instruction::Code opcode) { return Instruction::INVOKE_VIRTUAL <= opcode && opcode <= Instruction::INVOKE_INTERFACE_RANGE && opcode != Instruction::RETURN_VOID_NO_BARRIER; } constexpr bool IsInstructionQuickInvoke(Instruction::Code opcode) { return opcode == Instruction::INVOKE_VIRTUAL_QUICK || opcode == Instruction::INVOKE_VIRTUAL_RANGE_QUICK; } constexpr bool IsInstructionInvokeStatic(Instruction::Code opcode) { return opcode == Instruction::INVOKE_STATIC || opcode == Instruction::INVOKE_STATIC_RANGE; } constexpr bool IsInstructionGoto(Instruction::Code opcode) { return Instruction::GOTO <= opcode && opcode <= Instruction::GOTO_32; } constexpr bool IsInstructionIfCc(Instruction::Code opcode) { return Instruction::IF_EQ <= opcode && opcode <= Instruction::IF_LE; } constexpr bool IsInstructionIfCcZ(Instruction::Code opcode) { return Instruction::IF_EQZ <= opcode && opcode <= Instruction::IF_LEZ; } constexpr bool IsInstructionIGet(Instruction::Code code) { return Instruction::IGET <= code && code <= Instruction::IGET_SHORT; } constexpr bool IsInstructionIPut(Instruction::Code code) { return Instruction::IPUT <= code && code <= Instruction::IPUT_SHORT; } constexpr bool IsInstructionSGet(Instruction::Code code) { return Instruction::SGET <= code && code <= Instruction::SGET_SHORT; } constexpr bool IsInstructionSPut(Instruction::Code code) { return Instruction::SPUT <= code && code <= Instruction::SPUT_SHORT; } constexpr bool IsInstructionAGet(Instruction::Code code) { return Instruction::AGET <= code && code <= Instruction::AGET_SHORT; } constexpr bool IsInstructionAPut(Instruction::Code code) { return Instruction::APUT <= code && code <= Instruction::APUT_SHORT; } constexpr bool IsInstructionIGetOrIPut(Instruction::Code code) { return Instruction::IGET <= code && code <= Instruction::IPUT_SHORT; } constexpr bool IsInstructionIGetQuickOrIPutQuick(Instruction::Code code) { return (code >= Instruction::IGET_QUICK && code <= Instruction::IPUT_OBJECT_QUICK) || (code >= Instruction::IPUT_BOOLEAN_QUICK && code <= Instruction::IGET_SHORT_QUICK); } constexpr bool IsInstructionSGetOrSPut(Instruction::Code code) { return Instruction::SGET <= code && code <= Instruction::SPUT_SHORT; } constexpr bool IsInstructionAGetOrAPut(Instruction::Code code) { return Instruction::AGET <= code && code <= Instruction::APUT_SHORT; } constexpr bool IsInstructionBinOp2Addr(Instruction::Code code) { return Instruction::ADD_INT_2ADDR <= code && code <= Instruction::REM_DOUBLE_2ADDR; } constexpr bool IsInvokeInstructionRange(Instruction::Code opcode) { DCHECK(IsInstructionInvoke(opcode)); return opcode >= Instruction::INVOKE_VIRTUAL_RANGE; } constexpr DexInvokeType InvokeInstructionType(Instruction::Code opcode) { DCHECK(IsInstructionInvoke(opcode)); return static_cast(IsInvokeInstructionRange(opcode) ? (opcode - Instruction::INVOKE_VIRTUAL_RANGE) : (opcode - Instruction::INVOKE_VIRTUAL)); } constexpr DexMemAccessType IGetMemAccessType(Instruction::Code code) { DCHECK(IsInstructionIGet(code)); return static_cast(code - Instruction::IGET); } constexpr DexMemAccessType IPutMemAccessType(Instruction::Code code) { DCHECK(IsInstructionIPut(code)); return static_cast(code - Instruction::IPUT); } constexpr DexMemAccessType SGetMemAccessType(Instruction::Code code) { DCHECK(IsInstructionSGet(code)); return static_cast(code - Instruction::SGET); } constexpr DexMemAccessType SPutMemAccessType(Instruction::Code code) { DCHECK(IsInstructionSPut(code)); return static_cast(code - Instruction::SPUT); } constexpr DexMemAccessType AGetMemAccessType(Instruction::Code code) { DCHECK(IsInstructionAGet(code)); return static_cast(code - Instruction::AGET); } constexpr DexMemAccessType APutMemAccessType(Instruction::Code code) { DCHECK(IsInstructionAPut(code)); return static_cast(code - Instruction::APUT); } constexpr DexMemAccessType IGetOrIPutMemAccessType(Instruction::Code code) { DCHECK(IsInstructionIGetOrIPut(code)); return (code >= Instruction::IPUT) ? IPutMemAccessType(code) : IGetMemAccessType(code); } inline DexMemAccessType IGetQuickOrIPutQuickMemAccessType(Instruction::Code code) { DCHECK(IsInstructionIGetQuickOrIPutQuick(code)); switch (code) { case Instruction::IGET_QUICK: case Instruction::IPUT_QUICK: return kDexMemAccessWord; case Instruction::IGET_WIDE_QUICK: case Instruction::IPUT_WIDE_QUICK: return kDexMemAccessWide; case Instruction::IGET_OBJECT_QUICK: case Instruction::IPUT_OBJECT_QUICK: return kDexMemAccessObject; case Instruction::IGET_BOOLEAN_QUICK: case Instruction::IPUT_BOOLEAN_QUICK: return kDexMemAccessBoolean; case Instruction::IGET_BYTE_QUICK: case Instruction::IPUT_BYTE_QUICK: return kDexMemAccessByte; case Instruction::IGET_CHAR_QUICK: case Instruction::IPUT_CHAR_QUICK: return kDexMemAccessChar; case Instruction::IGET_SHORT_QUICK: case Instruction::IPUT_SHORT_QUICK: return kDexMemAccessShort; default: LOG(FATAL) << code; UNREACHABLE(); } } constexpr DexMemAccessType SGetOrSPutMemAccessType(Instruction::Code code) { DCHECK(IsInstructionSGetOrSPut(code)); return (code >= Instruction::SPUT) ? SPutMemAccessType(code) : SGetMemAccessType(code); } constexpr DexMemAccessType AGetOrAPutMemAccessType(Instruction::Code code) { DCHECK(IsInstructionAGetOrAPut(code)); return (code >= Instruction::APUT) ? APutMemAccessType(code) : AGetMemAccessType(code); } } // namespace art #endif // ART_LIBDEXFILE_DEX_DEX_INSTRUCTION_UTILS_H_