/* * Copyright (c) 2018-2020, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #ifdef KERNEL # include #endif namespace AK { template class OwnPtr; template class RefPtr; template ALWAYS_INLINE void ref_if_not_null(T* ptr) { if (ptr) ptr->ref(); } template ALWAYS_INLINE void unref_if_not_null(T* ptr) { if (ptr) ptr->unref(); } template class NonnullRefPtr { template friend class RefPtr; template friend class NonnullRefPtr; template friend class WeakPtr; public: using ElementType = T; enum AdoptTag { Adopt }; ALWAYS_INLINE NonnullRefPtr(const T& object) : m_bits((FlatPtr)&object) { VERIFY(!(m_bits & 1)); const_cast(object).ref(); } template ALWAYS_INLINE NonnullRefPtr(const U& object) : m_bits((FlatPtr) static_cast(&object)) { VERIFY(!(m_bits & 1)); const_cast(static_cast(object)).ref(); } ALWAYS_INLINE NonnullRefPtr(AdoptTag, T& object) : m_bits((FlatPtr)&object) { VERIFY(!(m_bits & 1)); } ALWAYS_INLINE NonnullRefPtr(NonnullRefPtr&& other) : m_bits((FlatPtr)&other.leak_ref()) { VERIFY(!(m_bits & 1)); } template ALWAYS_INLINE NonnullRefPtr(NonnullRefPtr&& other) : m_bits((FlatPtr)&other.leak_ref()) { VERIFY(!(m_bits & 1)); } ALWAYS_INLINE NonnullRefPtr(const NonnullRefPtr& other) : m_bits((FlatPtr)other.add_ref()) { VERIFY(!(m_bits & 1)); } template ALWAYS_INLINE NonnullRefPtr(const NonnullRefPtr& other) : m_bits((FlatPtr)other.add_ref()) { VERIFY(!(m_bits & 1)); } ALWAYS_INLINE ~NonnullRefPtr() { assign(nullptr); #ifdef SANITIZE_PTRS if constexpr (sizeof(T*) == 8) m_bits.store(0xb0b0b0b0b0b0b0b0, AK::MemoryOrder::memory_order_relaxed); else m_bits.store(0xb0b0b0b0, AK::MemoryOrder::memory_order_relaxed); #endif } template NonnullRefPtr(const OwnPtr&) = delete; template NonnullRefPtr& operator=(const OwnPtr&) = delete; template NonnullRefPtr(const RefPtr&) = delete; template NonnullRefPtr& operator=(const RefPtr&) = delete; NonnullRefPtr(const RefPtr&) = delete; NonnullRefPtr& operator=(const RefPtr&) = delete; NonnullRefPtr& operator=(const NonnullRefPtr& other) { if (this != &other) assign(other.add_ref()); return *this; } template NonnullRefPtr& operator=(const NonnullRefPtr& other) { assign(other.add_ref()); return *this; } ALWAYS_INLINE NonnullRefPtr& operator=(NonnullRefPtr&& other) { if (this != &other) assign(&other.leak_ref()); return *this; } template NonnullRefPtr& operator=(NonnullRefPtr&& other) { assign(&other.leak_ref()); return *this; } NonnullRefPtr& operator=(const T& object) { const_cast(object).ref(); assign(const_cast(&object)); return *this; } [[nodiscard]] ALWAYS_INLINE T& leak_ref() { T* ptr = exchange(nullptr); VERIFY(ptr); return *ptr; } ALWAYS_INLINE T* ptr() { return as_nonnull_ptr(); } ALWAYS_INLINE const T* ptr() const { return as_nonnull_ptr(); } ALWAYS_INLINE T* operator->() { return as_nonnull_ptr(); } ALWAYS_INLINE const T* operator->() const { return as_nonnull_ptr(); } ALWAYS_INLINE T& operator*() { return *as_nonnull_ptr(); } ALWAYS_INLINE const T& operator*() const { return *as_nonnull_ptr(); } ALWAYS_INLINE operator T*() { return as_nonnull_ptr(); } ALWAYS_INLINE operator const T*() const { return as_nonnull_ptr(); } ALWAYS_INLINE operator T&() { return *as_nonnull_ptr(); } ALWAYS_INLINE operator const T&() const { return *as_nonnull_ptr(); } operator bool() const = delete; bool operator!() const = delete; void swap(NonnullRefPtr& other) { if (this == &other) return; // NOTE: swap is not atomic! T* other_ptr = other.exchange(nullptr); T* ptr = exchange(other_ptr); other.exchange(ptr); } template void swap(NonnullRefPtr& other) { // NOTE: swap is not atomic! U* other_ptr = other.exchange(nullptr); T* ptr = exchange(other_ptr); other.exchange(ptr); } private: NonnullRefPtr() = delete; ALWAYS_INLINE T* as_ptr() const { return (T*)(m_bits.load(AK::MemoryOrder::memory_order_relaxed) & ~(FlatPtr)1); } ALWAYS_INLINE T* as_nonnull_ptr() const { T* ptr = (T*)(m_bits.load(AK::MemoryOrder::memory_order_relaxed) & ~(FlatPtr)1); VERIFY(ptr); return ptr; } template void do_while_locked(F f) const { #ifdef KERNEL // We don't want to be pre-empted while we have the lock bit set Kernel::ScopedCritical critical; #endif FlatPtr bits; for (;;) { bits = m_bits.fetch_or(1, AK::MemoryOrder::memory_order_acq_rel); if (!(bits & 1)) break; #ifdef KERNEL Kernel::Processor::wait_check(); #endif } VERIFY(!(bits & 1)); f((T*)bits); m_bits.store(bits, AK::MemoryOrder::memory_order_release); } ALWAYS_INLINE void assign(T* new_ptr) { T* prev_ptr = exchange(new_ptr); unref_if_not_null(prev_ptr); } ALWAYS_INLINE T* exchange(T* new_ptr) { VERIFY(!((FlatPtr)new_ptr & 1)); #ifdef KERNEL // We don't want to be pre-empted while we have the lock bit set Kernel::ScopedCritical critical; #endif // Only exchange while not locked FlatPtr expected = m_bits.load(AK::MemoryOrder::memory_order_relaxed); for (;;) { expected &= ~(FlatPtr)1; // only if lock bit is not set if (m_bits.compare_exchange_strong(expected, (FlatPtr)new_ptr, AK::MemoryOrder::memory_order_acq_rel)) break; #ifdef KERNEL Kernel::Processor::wait_check(); #endif } VERIFY(!(expected & 1)); return (T*)expected; } T* add_ref() const { #ifdef KERNEL // We don't want to be pre-empted while we have the lock bit set Kernel::ScopedCritical critical; #endif // Lock the pointer FlatPtr expected = m_bits.load(AK::MemoryOrder::memory_order_relaxed); for (;;) { expected &= ~(FlatPtr)1; // only if lock bit is not set if (m_bits.compare_exchange_strong(expected, expected | 1, AK::MemoryOrder::memory_order_acq_rel)) break; #ifdef KERNEL Kernel::Processor::wait_check(); #endif } // Add a reference now that we locked the pointer ref_if_not_null((T*)expected); // Unlock the pointer again m_bits.store(expected, AK::MemoryOrder::memory_order_release); return (T*)expected; } mutable Atomic m_bits { 0 }; }; template inline NonnullRefPtr adopt_ref(T& object) { return NonnullRefPtr(NonnullRefPtr::Adopt, object); } template struct Formatter> : Formatter { void format(FormatBuilder& builder, const NonnullRefPtr& value) { Formatter::format(builder, value.ptr()); } }; template inline void swap(NonnullRefPtr& a, NonnullRefPtr& b) { a.swap(b); } } template struct Traits> : public GenericTraits> { using PeekType = T*; using ConstPeekType = const T*; static unsigned hash(const NonnullRefPtr& p) { return ptr_hash(p.ptr()); } static bool equals(const NonnullRefPtr& a, const NonnullRefPtr& b) { return a.ptr() == b.ptr(); } }; using AK::adopt_ref; using AK::NonnullRefPtr;