blob: 7231733a7cbe63d3ba734b2a38f3d40f16829a34 [file] [log] [blame]
* Copyright (C) 2011 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
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* See the License for the specific language governing permissions and
* limitations under the License.
#include <iosfwd>
#include <string>
#include "base/macros.h"
namespace art {
enum InstructionSet {
std::ostream& operator<<(std::ostream& os, const InstructionSet& rhs);
const char* GetInstructionSetString(InstructionSet isa);
InstructionSet GetInstructionSetFromString(const char* instruction_set);
size_t GetInstructionSetPointerSize(InstructionSet isa);
size_t GetInstructionSetAlignment(InstructionSet isa);
bool Is64BitInstructionSet(InstructionSet isa);
size_t GetBytesPerGprSpillLocation(InstructionSet isa);
size_t GetBytesPerFprSpillLocation(InstructionSet isa);
#if defined(__arm__)
static constexpr InstructionSet kRuntimeISA = kArm;
#elif defined(__aarch64__)
static constexpr InstructionSet kRuntimeISA = kArm64;
#elif defined(__mips__)
static constexpr InstructionSet kRuntimeISA = kMips;
#elif defined(__i386__)
static constexpr InstructionSet kRuntimeISA = kX86;
#elif defined(__x86_64__)
static constexpr InstructionSet kRuntimeISA = kX86_64;
static constexpr InstructionSet kRuntimeISA = kNone;
enum InstructionFeatures {
kHwDiv = 0x1, // Supports hardware divide.
kHwLpae = 0x2, // Supports Large Physical Address Extension.
// This is a bitmask of supported features per architecture.
class PACKED(4) InstructionSetFeatures {
InstructionSetFeatures() : mask_(0) {}
explicit InstructionSetFeatures(uint32_t mask) : mask_(mask) {}
static InstructionSetFeatures GuessInstructionSetFeatures();
bool HasDivideInstruction() const {
return (mask_ & kHwDiv) != 0;
void SetHasDivideInstruction(bool v) {
mask_ = (mask_ & ~kHwDiv) | (v ? kHwDiv : 0);
bool HasLpae() const {
return (mask_ & kHwLpae) != 0;
void SetHasLpae(bool v) {
mask_ = (mask_ & ~kHwLpae) | (v ? kHwLpae : 0);
std::string GetFeatureString() const;
// Other features in here.
bool operator==(const InstructionSetFeatures &peer) const {
return mask_ == peer.mask_;
bool operator!=(const InstructionSetFeatures &peer) const {
return mask_ != peer.mask_;
bool operator<=(const InstructionSetFeatures &peer) const {
return (mask_ & peer.mask_) == mask_;
uint32_t mask_;
// The following definitions create return types for two word-sized entities that will be passed
// in registers so that memory operations for the interface trampolines can be avoided. The entities
// are the resolved method and the pointer to the code to be invoked.
// On x86, ARM32 and MIPS, this is given for a *scalar* 64bit value. The definition thus *must* be
// uint64_t or long long int.
// On x86_64 and ARM64, structs are decomposed for allocation, so we can create a structs of two
// size_t-sized values.
// We need two operations:
// 1) A flag value that signals failure. The assembly stubs expect the lower part to be "0".
// GetTwoWordFailureValue() will return a value that has lower part == 0.
// 2) A value that combines two word-sized values.
// GetTwoWordSuccessValue() constructs this.
// IMPORTANT: If you use this to transfer object pointers, it is your responsibility to ensure
// that the object does not move or the value is updated. Simple use of this is NOT SAFE
// when the garbage collector can move objects concurrently. Ensure that required locks
// are held when using!
#if defined(__i386__) || defined(__arm__) || defined(__mips__)
typedef uint64_t TwoWordReturn;
// Encodes method_ptr==nullptr and code_ptr==nullptr
static inline constexpr TwoWordReturn GetTwoWordFailureValue() {
return 0;
// Use the lower 32b for the method pointer and the upper 32b for the code pointer.
static inline TwoWordReturn GetTwoWordSuccessValue(uintptr_t hi, uintptr_t lo) {
uint32_t lo32 = static_cast<uint32_t>(lo);
uint64_t hi64 = static_cast<uint64_t>(hi);
return ((hi64 << 32) | lo32);
#elif defined(__x86_64__) || defined(__aarch64__)
struct TwoWordReturn {
uintptr_t lo;
uintptr_t hi;
// Encodes method_ptr==nullptr. Leaves random value in code pointer.
static inline TwoWordReturn GetTwoWordFailureValue() {
TwoWordReturn ret;
ret.lo = 0;
return ret;
// Write values into their respective members.
static inline TwoWordReturn GetTwoWordSuccessValue(uintptr_t hi, uintptr_t lo) {
TwoWordReturn ret;
ret.lo = lo;
ret.hi = hi;
return ret;
#error "Unsupported architecture"
} // namespace art