diff options
Diffstat (limited to 'runtime/gc/accounting/space_bitmap.h')
-rw-r--r-- | runtime/gc/accounting/space_bitmap.h | 265 |
1 files changed, 265 insertions, 0 deletions
diff --git a/runtime/gc/accounting/space_bitmap.h b/runtime/gc/accounting/space_bitmap.h new file mode 100644 index 0000000..bb487d8 --- /dev/null +++ b/runtime/gc/accounting/space_bitmap.h @@ -0,0 +1,265 @@ +/* + * Copyright (C) 2008 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_SRC_GC_ACCOUNTING_SPACE_BITMAP_H_ +#define ART_SRC_GC_ACCOUNTING_SPACE_BITMAP_H_ + +#include "locks.h" +#include "globals.h" +#include "mem_map.h" +#include "UniquePtr.h" + +#include <limits.h> +#include <set> +#include <stdint.h> +#include <vector> + +namespace art { + +namespace mirror { + class Object; +} // namespace mirror + +namespace gc { +namespace accounting { + +class SpaceBitmap { + public: + // Alignment of objects within spaces. + static const size_t kAlignment = 8; + + typedef void Callback(mirror::Object* obj, void* arg); + + typedef void ScanCallback(mirror::Object* obj, void* finger, void* arg); + + typedef void SweepCallback(size_t ptr_count, mirror::Object** ptrs, void* arg); + + // Initialize a HeapBitmap so that it points to a bitmap large enough to cover a heap at + // heap_begin of heap_capacity bytes, where objects are guaranteed to be kAlignment-aligned. + static SpaceBitmap* Create(const std::string& name, byte* heap_begin, size_t heap_capacity); + + ~SpaceBitmap(); + + // <offset> is the difference from .base to a pointer address. + // <index> is the index of .bits that contains the bit representing + // <offset>. + static size_t OffsetToIndex(size_t offset) { + return offset / kAlignment / kBitsPerWord; + } + + static uintptr_t IndexToOffset(size_t index) { + return static_cast<uintptr_t>(index * kAlignment * kBitsPerWord); + } + + // Pack the bits in backwards so they come out in address order when using CLZ. + static word OffsetToMask(uintptr_t offset_) { + return static_cast<uintptr_t>(kWordHighBitMask) >> ((offset_ / kAlignment) % kBitsPerWord); + } + + inline bool Set(const mirror::Object* obj) { + return Modify(obj, true); + } + + inline bool Clear(const mirror::Object* obj) { + return Modify(obj, false); + } + + // Returns true if the object was previously marked. + bool AtomicTestAndSet(const mirror::Object* obj); + + // Fill the bitmap with zeroes. Returns the bitmap's memory to the system as a side-effect. + void Clear(); + + bool Test(const mirror::Object* obj) const; + + // Return true iff <obj> is within the range of pointers that this bitmap could potentially cover, + // even if a bit has not been set for it. + bool HasAddress(const void* obj) const { + // If obj < heap_begin_ then offset underflows to some very large value past the end of the + // bitmap. + const uintptr_t offset = reinterpret_cast<uintptr_t>(obj) - heap_begin_; + const size_t index = OffsetToIndex(offset); + return index < bitmap_size_ / kWordSize; + } + + void VisitRange(uintptr_t base, uintptr_t max, Callback* visitor, void* arg) const; + + class ClearVisitor { + public: + explicit ClearVisitor(SpaceBitmap* const bitmap) + : bitmap_(bitmap) { + } + + void operator ()(mirror::Object* obj) const { + bitmap_->Clear(obj); + } + private: + SpaceBitmap* const bitmap_; + }; + + template <typename Visitor> + void VisitRange(uintptr_t visit_begin, uintptr_t visit_end, const Visitor& visitor) const { + for (; visit_begin < visit_end; visit_begin += kAlignment ) { + visitor(reinterpret_cast<mirror::Object*>(visit_begin)); + } + } + + template <typename Visitor, typename FingerVisitor> + void VisitMarkedRange(uintptr_t visit_begin, uintptr_t visit_end, + const Visitor& visitor, const FingerVisitor& finger_visitor) const + EXCLUSIVE_LOCKS_REQUIRED(Locks::heap_bitmap_lock_) + SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); + + void Walk(Callback* callback, void* arg) + SHARED_LOCKS_REQUIRED(Locks::heap_bitmap_lock_); + + void InOrderWalk(Callback* callback, void* arg) + SHARED_LOCKS_REQUIRED(Locks::heap_bitmap_lock_, Locks::mutator_lock_); + + static void SweepWalk(const SpaceBitmap& live, + const SpaceBitmap& mark, + uintptr_t base, uintptr_t max, + SweepCallback* thunk, void* arg); + + void CopyFrom(SpaceBitmap* source_bitmap); + + // Starting address of our internal storage. + word* Begin() { + return bitmap_begin_; + } + + // Size of our internal storage + size_t Size() const { + return bitmap_size_; + } + + // Size in bytes of the memory that the bitmaps spans. + size_t HeapSize() const { + return IndexToOffset(Size() / kWordSize); + } + + uintptr_t HeapBegin() const { + return heap_begin_; + } + + // The maximum address which the bitmap can span. (HeapBegin() <= object < HeapLimit()). + uintptr_t HeapLimit() const { + return HeapBegin() + static_cast<uintptr_t>(HeapSize()); + } + + // Set the max address which can covered by the bitmap. + void SetHeapLimit(uintptr_t new_end); + + std::string GetName() const; + void SetName(const std::string& name); + + std::string Dump() const; + + const void* GetObjectWordAddress(const mirror::Object* obj) const { + uintptr_t addr = reinterpret_cast<uintptr_t>(obj); + const uintptr_t offset = addr - heap_begin_; + const size_t index = OffsetToIndex(offset); + return &bitmap_begin_[index]; + } + private: + // TODO: heap_end_ is initialized so that the heap bitmap is empty, this doesn't require the -1, + // however, we document that this is expected on heap_end_ + SpaceBitmap(const std::string& name, MemMap* mem_map, word* bitmap_begin, size_t bitmap_size, const void* heap_begin) + : mem_map_(mem_map), bitmap_begin_(bitmap_begin), bitmap_size_(bitmap_size), + heap_begin_(reinterpret_cast<uintptr_t>(heap_begin)), + name_(name) {} + + bool Modify(const mirror::Object* obj, bool do_set); + + // Backing storage for bitmap. + UniquePtr<MemMap> mem_map_; + + // This bitmap itself, word sized for efficiency in scanning. + word* const bitmap_begin_; + + // Size of this bitmap. + size_t bitmap_size_; + + // The base address of the heap, which corresponds to the word containing the first bit in the + // bitmap. + const uintptr_t heap_begin_; + + // Name of this bitmap. + std::string name_; +}; + +// Like a bitmap except it keeps track of objects using sets. +class SpaceSetMap { + public: + typedef std::set<const mirror::Object*> Objects; + + bool IsEmpty() const { + return contained_.empty(); + } + + inline void Set(const mirror::Object* obj) { + contained_.insert(obj); + } + + inline void Clear(const mirror::Object* obj) { + Objects::iterator found = contained_.find(obj); + if (found != contained_.end()) { + contained_.erase(found); + } + } + + void Clear() { + contained_.clear(); + } + + inline bool Test(const mirror::Object* obj) const { + return contained_.find(obj) != contained_.end(); + } + + std::string GetName() const; + void SetName(const std::string& name); + + void Walk(SpaceBitmap::Callback* callback, void* arg) + SHARED_LOCKS_REQUIRED(GlobalSynchronization::heap_bitmap_lock_); + + void CopyFrom(const SpaceSetMap& space_set); + + template <typename Visitor> + void Visit(const Visitor& visitor) NO_THREAD_SAFETY_ANALYSIS { + for (Objects::iterator it = contained_.begin(); it != contained_.end(); ++it) { + visitor(*it); + } + } + + SpaceSetMap(const std::string& name) : name_(name) {} + ~SpaceSetMap() {} + + Objects& GetObjects() { + return contained_; + } + + private: + std::string name_; + Objects contained_; +}; + +std::ostream& operator << (std::ostream& stream, const SpaceBitmap& bitmap); + +} // namespace accounting +} // namespace gc +} // namespace art + +#endif // ART_SRC_GC_ACCOUNTING_SPACE_BITMAP_H_ |