2019-01-25 16:45:13 +00:00
|
|
|
// Copyright (c) 2019, the Dart project authors. Please see the AUTHORS file
|
|
|
|
// for details. All rights reserved. Use of this source code is governed by a
|
|
|
|
// BSD-style license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
#ifndef RUNTIME_VM_POINTER_TAGGING_H_
|
|
|
|
#define RUNTIME_VM_POINTER_TAGGING_H_
|
|
|
|
|
2019-09-05 21:41:42 +00:00
|
|
|
#include "platform/assert.h"
|
|
|
|
#include "platform/globals.h"
|
|
|
|
|
2019-01-25 16:45:13 +00:00
|
|
|
// This header defines constants associated with pointer tagging:
|
|
|
|
//
|
|
|
|
// * which bits determine whether or not this is a Smi value or a heap
|
|
|
|
// pointer;
|
|
|
|
// * which bits determine whether this is a pointer into a new or an old
|
|
|
|
// space.
|
|
|
|
|
|
|
|
namespace dart {
|
|
|
|
|
|
|
|
// Dart VM aligns all objects by 2 words in in the old space and misaligns them
|
|
|
|
// in new space. This allows to distinguish new and old pointers by their bits.
|
|
|
|
//
|
|
|
|
// Note: these bits depend on the word size.
|
|
|
|
template <intptr_t word_size, intptr_t word_size_log2>
|
|
|
|
struct ObjectAlignment {
|
|
|
|
// Alignment offsets are used to determine object age.
|
|
|
|
static constexpr intptr_t kNewObjectAlignmentOffset = word_size;
|
|
|
|
static constexpr intptr_t kOldObjectAlignmentOffset = 0;
|
|
|
|
static constexpr intptr_t kNewObjectBitPosition = word_size_log2;
|
|
|
|
|
|
|
|
// Object sizes are aligned to kObjectAlignment.
|
|
|
|
static constexpr intptr_t kObjectAlignment = 2 * word_size;
|
|
|
|
static constexpr intptr_t kObjectAlignmentLog2 = word_size_log2 + 1;
|
|
|
|
static constexpr intptr_t kObjectAlignmentMask = kObjectAlignment - 1;
|
2020-04-06 10:36:50 +00:00
|
|
|
|
|
|
|
// Discriminate between true and false based on the alignment bit.
|
|
|
|
static constexpr intptr_t kBoolValueBitPosition = kObjectAlignmentLog2;
|
|
|
|
static constexpr intptr_t kBoolValueMask = 1 << kBoolValueBitPosition;
|
|
|
|
|
2021-03-09 20:27:00 +00:00
|
|
|
// Discriminate between bool and null based on bit after the alignment bit.
|
|
|
|
static constexpr intptr_t kBoolVsNullBitPosition = kObjectAlignmentLog2 + 1;
|
|
|
|
static constexpr intptr_t kBoolVsNullMask = 1 << kBoolVsNullBitPosition;
|
|
|
|
|
2020-04-06 10:36:50 +00:00
|
|
|
static constexpr intptr_t kTrueOffsetFromNull = kObjectAlignment * 2;
|
|
|
|
static constexpr intptr_t kFalseOffsetFromNull = kObjectAlignment * 3;
|
2019-01-25 16:45:13 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
using HostObjectAlignment = ObjectAlignment<kWordSize, kWordSizeLog2>;
|
|
|
|
|
|
|
|
static constexpr intptr_t kNewObjectAlignmentOffset =
|
|
|
|
HostObjectAlignment::kNewObjectAlignmentOffset;
|
|
|
|
static constexpr intptr_t kOldObjectAlignmentOffset =
|
|
|
|
HostObjectAlignment::kOldObjectAlignmentOffset;
|
|
|
|
static constexpr intptr_t kNewObjectBitPosition =
|
|
|
|
HostObjectAlignment::kNewObjectBitPosition;
|
|
|
|
static constexpr intptr_t kObjectAlignment =
|
|
|
|
HostObjectAlignment::kObjectAlignment;
|
|
|
|
static constexpr intptr_t kObjectAlignmentLog2 =
|
|
|
|
HostObjectAlignment::kObjectAlignmentLog2;
|
|
|
|
static constexpr intptr_t kObjectAlignmentMask =
|
|
|
|
HostObjectAlignment::kObjectAlignmentMask;
|
2020-04-06 10:36:50 +00:00
|
|
|
static constexpr intptr_t kBoolValueBitPosition =
|
|
|
|
HostObjectAlignment::kBoolValueBitPosition;
|
|
|
|
static constexpr intptr_t kBoolValueMask = HostObjectAlignment::kBoolValueMask;
|
2021-03-09 20:27:00 +00:00
|
|
|
static constexpr intptr_t kBoolVsNullBitPosition =
|
|
|
|
HostObjectAlignment::kBoolVsNullBitPosition;
|
|
|
|
static constexpr intptr_t kBoolVsNullMask =
|
|
|
|
HostObjectAlignment::kBoolVsNullMask;
|
2020-04-06 10:36:50 +00:00
|
|
|
static constexpr intptr_t kTrueOffsetFromNull =
|
|
|
|
HostObjectAlignment::kTrueOffsetFromNull;
|
|
|
|
static constexpr intptr_t kFalseOffsetFromNull =
|
|
|
|
HostObjectAlignment::kFalseOffsetFromNull;
|
2019-01-25 16:45:13 +00:00
|
|
|
|
2019-10-17 21:45:38 +00:00
|
|
|
// The largest value of kObjectAlignment across all configurations.
|
|
|
|
static constexpr intptr_t kMaxObjectAlignment = 16;
|
|
|
|
COMPILE_ASSERT(kMaxObjectAlignment >= kObjectAlignment);
|
|
|
|
|
2019-01-25 16:45:13 +00:00
|
|
|
// On all targets heap pointers are tagged by set least significant bit.
|
|
|
|
//
|
|
|
|
// To recover address of the actual heap object kHeapObjectTag needs to be
|
|
|
|
// subtracted from the tagged pointer value.
|
|
|
|
//
|
|
|
|
// Smi-s (small integers) have least significant bit cleared.
|
|
|
|
//
|
|
|
|
// To recover the integer value tagged pointer value needs to be shifted
|
|
|
|
// right by kSmiTagShift.
|
|
|
|
enum {
|
|
|
|
kSmiTag = 0,
|
|
|
|
kHeapObjectTag = 1,
|
|
|
|
kSmiTagSize = 1,
|
|
|
|
kSmiTagMask = 1,
|
|
|
|
kSmiTagShift = 1,
|
|
|
|
};
|
|
|
|
|
2021-02-18 17:47:37 +00:00
|
|
|
#if !defined(DART_COMPRESSED_POINTERS)
|
|
|
|
static constexpr uintptr_t kHeapBaseMask = 0;
|
|
|
|
#else
|
|
|
|
static constexpr uintptr_t kHeapBaseMask = ~(4LL * GB - 1);
|
|
|
|
#endif
|
|
|
|
|
2019-01-25 16:45:13 +00:00
|
|
|
} // namespace dart
|
|
|
|
|
|
|
|
#endif // RUNTIME_VM_POINTER_TAGGING_H_
|