// Alex Horn, University of Oxford // // The source code is structured into three main parts: // // 1) Data structures and algorithm of the linearizability tester, // including a new optional partitioning algorithm; // // 2) Immutable data types for sets, registers and stacks with // efficient equality checks; // // 3) Unit tests and experiments with TBB, EMBB, and etcd. #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include // functional testing and experiments #include #include #include /// Allow users to print out counterexamples #define _LT_DEBUG_ /// Built-in timeout feature #define _LT_TIMEOUT_ #ifdef _LT_DEBUG_ #include #include #include #include #include #endif #include #include #include #ifdef _LT_TIMEOUT_ #include #endif #ifdef _DEBUG #ifndef DBG_NEW #define DBG_NEW new ( _NORMAL_BLOCK , __FILE__ , __LINE__ ) #define new DBG_NEW #endif #endif // _DEBUG #if __cplusplus <= 201103L // since C++14 in std, see Herb Sutter's blog template std::unique_ptr make_unique(Args&& ...args) { return std::unique_ptr(new T(std::forward(args)...)); } #else using std::make_unique; #endif /// Linearizability tester namespace lt { /************* Core data structures && algorithms *************/ template class Entry; /// Doubly-linked list of log entries /// S - sequential data type template using EntryPtr = Entry*; /// Bounded stack of call entries that have been linearized /// S - sequential data type template class Stack { private: typedef std::tuple, S> Pair; typedef std::vector Pairs; typedef typename Pairs::size_type SizeType; // A constant-size vector Pairs m_vector; SizeType m_top; public: /// Create a new stack of bounded height /// \post: if capacity is positive, then !is_full() Stack(SizeType capacity) : m_vector(capacity), m_top{ 0U } { assert(capacity == 0U || !is_full()); } /// History length in the stack SizeType size() const noexcept { return m_top; } /// Is size() zero? bool is_empty() const noexcept { return 0U == size(); } /// Is size() equal to the stack's capacity? bool is_full() const noexcept { return m_top == m_vector.size(); } /// \pre: !is_empty() const Pair& top() const noexcept { assert(!is_empty()); return m_vector[m_top - 1U]; } /// Add an entry to the top() of the stack /// \pre: !is_full() /// \pre: ptr->is_call() void push(EntryPtr, S&&); /// Remove count entries from the stack /// \pre: 0 < count <= size() void pop(unsigned count = 1U) { assert(0U < count); assert(count <= size()); m_top -= count; } /// \internal EntryPtr entry_ptr(std::size_t pos) { assert(pos < m_top); return std::get<0>(m_vector[pos]); } }; enum class Option : unsigned char { NEVER_CACHE, LRU_CACHE, ALWAYS_CACHE, }; template class Entry; template class Log; template class ConcurrentLog; template class Slicer; template class LinearizabilityTester; /// A kind of "functor" in C++ terminology /// S - sequential data type template class Op { private: friend class Entry; // Is m_partition defined? bool m_is_partitionable; unsigned m_partition; // modified by Entry unsigned ref_counter; #ifdef _LT_DEBUG_ virtual std::ostream& print(std::ostream&) const = 0; #endif virtual std::pair internal_apply(const S&, const Op&) { return{}; } public: Op() : m_is_partitionable{ false }, m_partition{ 0U }, ref_counter{ 0U } {} Op(unsigned partition) : m_is_partitionable{ true }, m_partition{ partition }, ref_counter{ 0U } {} Op(bool is_partitionable, unsigned partition) : m_is_partitionable{ is_partitionable }, m_partition{ partition }, ref_counter{ 0U } {} virtual ~Op() { assert(ref_counter == 0); } /// Is partition() defined? bool is_partitionable() const noexcept { return m_is_partitionable; } /// \pre: is_partitionable() unsigned partition() const { assert(m_is_partitionable); return m_partition; } /// Returns true exactly if the operation could be applied std::pair apply(const S& s, const Op& op) { return internal_apply(s, op); } #ifdef _LT_DEBUG_ friend std::ostream& operator<<(std::ostream& os, const Op& op) { return op.print(os); } #endif }; /// Fixed-size set of bits with persistence features class Bitset { public: typedef std::size_t Pos; private: friend struct BitsetHash; friend class FlexibleBitset; typedef unsigned long Block; typedef std::vector Blocks; typedef Blocks::size_type BlockIndex; /// Accessible bits in a Block typedef unsigned BlockWidth; static constexpr BlockWidth s_bits_per_block = static_cast(sizeof(Block) * CHAR_BIT); static BlockIndex block_index(Pos pos) noexcept { return pos / s_bits_per_block; } static BlockIndex blocks_size(Pos max_pos) noexcept { return block_index(max_pos) + 1U; } static BlockWidth bit_index(Pos pos) noexcept { return static_cast(pos % s_bits_per_block); } static Block bit_mask(Pos pos) noexcept { return Block(1U) << bit_index(pos); } /// only resized by FlexibleBitset Blocks m_blocks; std::size_t m_hash; unsigned m_number_of_set_bits; Block& find_block(Pos pos) { BlockIndex i{ block_index(pos) }; assert(i < m_blocks.size()); return m_blocks[i]; } // We exploit the fact that XOR forms an abelian group: // first, clear hash of old block; then, hash new block. void update_hash(Block old_block, Block new_block) { m_hash ^= old_block; m_hash ^= new_block; } public: Bitset(Pos max_pos) : m_blocks(blocks_size(max_pos)), m_hash{ 0U }, m_number_of_set_bits{ 0U } {} bool is_empty() const noexcept { return m_number_of_set_bits == 0U; } bool set(Pos pos) { Block& block = find_block(pos); const Block copy_block{ block }; block |= bit_mask(pos); update_hash(copy_block, block); bool ok{ block != copy_block }; m_number_of_set_bits += ok; return ok; } Bitset immutable_set(Pos pos) const { Bitset copy{ *this }; copy.set(pos); return copy; } bool is_set(Pos pos) const { BlockIndex i{ block_index(pos) }; if (i < m_blocks.size()) return (m_blocks[i] & bit_mask(pos)) != 0U; return false; } bool reset(Pos pos) { Block& block = find_block(pos); const Block copy_block{ block }; block &= ~bit_mask(pos); update_hash(copy_block, block); bool ok{ block != copy_block }; m_number_of_set_bits -= ok; return ok; } Bitset immutable_reset(Pos pos) const { Bitset copy{ *this }; copy.reset(pos); return copy; } // Same number of blocks && identical bits in all those blocks? bool operator==(const Bitset& other) const noexcept { return m_number_of_set_bits == other.m_number_of_set_bits && m_blocks == other.m_blocks; } bool operator!=(const Bitset& other) const noexcept { return m_number_of_set_bits != other.m_number_of_set_bits || m_blocks != other.m_blocks; } }; /// Constant-time, O(1), hash function struct BitsetHash { std::size_t operator()(const Bitset& bitset) const noexcept { return bitset.m_hash; } }; /// States of abstract data types namespace state { template struct Hash { std::size_t operator()(const T&) const noexcept; }; } template using OpPtr = std::unique_ptr>; /// Call/ret log entry /// S - sequential data type template class Entry { private: friend class Log; friend class Slicer; friend class LinearizabilityTester; friend class LinearizabilityTester; friend class LinearizabilityTester; // Ref counted pointer because we need to copy logs so that we // can experimentally compare different linearizability testers // // However, this is an implementation detail and the strict type // of OpPtr enforces at compile-time that we manage the // ownership of these kind of pointers on the user's behalf. Op* m_op_ptr; unsigned m_entry_id; std::thread::id m_thread_id; EntryPtr m_match; bool m_is_call; void inc_ref_counter() const noexcept { if (m_op_ptr != nullptr) ++m_op_ptr->ref_counter; } void dec_ref_counter() const { assert(m_op_ptr == nullptr || 0 < m_op_ptr->ref_counter); if (m_op_ptr != nullptr && --m_op_ptr->ref_counter == 0) delete m_op_ptr; } /// Log head /// \post: if _next is !nullptr, then _next->prev == this Entry(EntryPtr _next) : m_op_ptr{ nullptr }, m_entry_id{}, m_thread_id{}, m_match{ nullptr }, m_is_call{ false }, prev{ nullptr }, next{ _next } { if (_next != nullptr) _next->prev = this; } public: ~Entry() { dec_ref_counter(); } EntryPtr prev; EntryPtr next; Entry() : m_op_ptr{ nullptr }, m_entry_id{}, m_thread_id{}, m_match{ nullptr }, m_is_call{ false }, prev{ nullptr }, next{ nullptr } {} Entry(const Entry& entry) : m_op_ptr{ entry.m_op_ptr }, m_entry_id{ entry.m_entry_id }, m_thread_id{ entry.m_thread_id }, m_match{ entry.m_match }, m_is_call{ entry.m_is_call }, prev{ entry.prev }, next{ entry.next } { inc_ref_counter(); } Entry& operator=(const Entry& entry) { entry.inc_ref_counter(); dec_ref_counter(); m_op_ptr = entry.m_op_ptr; m_entry_id = entry.m_entry_id; m_thread_id = entry.m_thread_id; m_match = entry.m_match; m_is_call = entry.m_is_call; prev = entry.prev; next = entry.next; return *this; } Entry& operator=(Entry&& entry) { // only decrement required (due to move semantics) dec_ref_counter(); m_op_ptr = entry.m_op_ptr; m_entry_id = entry.m_entry_id; m_thread_id = entry.m_thread_id; m_match = entry.m_match; m_is_call = entry.m_is_call; prev = entry.prev; next = entry.next; entry.m_op_ptr = nullptr; entry.m_entry_id = 0; entry.m_thread_id = 0; entry.m_match = nullptr; entry.m_is_call = false; entry.prev = nullptr; entry.next = nullptr; return *this; } /// \pre: set_match && set_op have been called with non-null arguments bool is_partitionable() const { assert(m_match != nullptr); assert(m_match->m_op_ptr != nullptr); assert(m_op_ptr->m_is_partitionable == m_match->m_op_ptr->m_is_partitionable); assert(m_op_ptr->m_partition == m_match->m_op_ptr->m_partition); return m_op_ptr->m_is_partitionable; } void set_op(OpPtr&& op_ptr) noexcept { m_op_ptr = op_ptr.release(); inc_ref_counter(); } Op& op() const { assert(m_op_ptr != nullptr); return *m_op_ptr; } const Op* const op_ptr() const noexcept { return m_op_ptr; } void set_entry_id(unsigned entry_id) noexcept { m_entry_id = entry_id; } unsigned entry_id() const noexcept { return m_entry_id; } void set_thread_id(std::thread::id thread_id) noexcept { m_thread_id = thread_id; } std::thread::id thread_id() const noexcept { return m_thread_id; } /// \pre: ret_entry_ptr->match() == nullptr /// \pre: !ret_entry_ptr->is_call() /// /// \post: this->is_call() /// \post: this == ret_entry_ptr->match() /// \post: this->match() == ret_entry_ptr /// \post: this->entry_id() == ret_entry_ptr->entry_id() /// \post: if this->is_partitionable() || ret_entry_ptr->is_partitionable(), /// then this->op().partition() == ret_entry_ptr->op().partition() void set_match(EntryPtr ret_entry_ptr) noexcept { assert(ret_entry_ptr->m_match == nullptr); assert(!ret_entry_ptr->is_call()); ret_entry_ptr->m_match = this; ret_entry_ptr->set_entry_id(m_entry_id); if (ret_entry_ptr->op().m_is_partitionable) { op().m_is_partitionable = ret_entry_ptr->op().m_is_partitionable; op().m_partition = ret_entry_ptr->op().m_partition; } else { ret_entry_ptr->op().m_is_partitionable = op().m_is_partitionable; ret_entry_ptr->op().m_partition = op().m_partition; } m_match = ret_entry_ptr; m_is_call = true; assert(is_call()); assert(this == ret_entry_ptr->match()); assert(match() == ret_entry_ptr); assert(entry_id() == ret_entry_ptr->entry_id()); assert(op().m_is_partitionable == ret_entry_ptr->op().m_is_partitionable); assert(op().m_partition == ret_entry_ptr->op().m_partition); } EntryPtr match() const noexcept { return m_match; } bool is_call() const noexcept { return m_is_call; } }; #ifdef _LT_DEBUG_ /// S - sequential data type template std::ostream& operator<<(std::ostream& os, EntryPtr entry_ptr) { if (entry_ptr == nullptr) return os << "entry id: none, thread id: none [nullptr]"; const Entry& entry = *entry_ptr; return os << "entry id: " << entry.entry_id() << ", thread id: " << entry.thread_id() << ", " << (entry.is_call() ? "call: " : "return: ") << entry.op(); } #endif template void Stack::push(EntryPtr ptr, S&& s) { assert(!is_full()); assert(ptr != nullptr); assert(ptr->is_call()); // no overflow m_vector[m_top++] = std::make_pair(ptr, std::move(s)); assert(0U != m_top); } /// Input to linearizabilty testers /// S - sequential data type template class LogInfo { private: friend class Slicer; EntryPtr m_log_head_ptr; std::size_t m_number_of_entries; public: /// \post: is_empty() LogInfo() : m_log_head_ptr{ nullptr }, m_number_of_entries{ 0U } {} /// \pre: number_of_entries is positive && even /// \pre: log_head_ptr is !nullptr /// \post: !is_empty() LogInfo(EntryPtr log_head_ptr, std::size_t number_of_entries) : m_log_head_ptr{ log_head_ptr }, m_number_of_entries{ number_of_entries } { assert(log_head_ptr != nullptr); assert(0U < m_number_of_entries); assert((m_number_of_entries & 1U) == 0U); } /// Ptr to the first entry in the log EntryPtr log_head_ptr() const noexcept { return m_log_head_ptr; } /// Total number of call entries plus return entries. /// Returns even number since every call is paired with a return std::size_t number_of_entries() const noexcept { return m_number_of_entries; } bool is_empty() const noexcept { return m_log_head_ptr == nullptr && m_number_of_entries == 0U; } }; #ifdef _LT_DEBUG_ /// S - sequential data type template std::ostream& operator<<(std::ostream& os, const LogInfo& log_info) { EntryPtr entry_ptr{ log_info.log_head_ptr() }; os << "log info, number of entries: " << log_info.number_of_entries() << std::endl; for (; entry_ptr != nullptr; entry_ptr = entry_ptr->next) os << entry_ptr << std::endl; return os; } #endif /// Bounded history log /// If you need thread-safety, use ConcurrentLog instead. /// /// S - sequential data type template class Log { private: // fixed-size vector typedef std::vector> Entries; public: typedef typename Entries::size_type Size; private: // we never resize the vector and so pointers into it are stable Size m_entry_id, m_index; Entries m_entries; EntryPtr m_last_entry_ptr; void link(Entry& entry) noexcept { if (m_last_entry_ptr != nullptr) m_last_entry_ptr->next = &entry; entry.prev = m_last_entry_ptr; } public: Log(const Log&) = delete; /// A history with at most capacity entries Log(Size capacity) : m_entry_id{ 0U }, m_index{ 0U }, m_entries(capacity), m_last_entry_ptr{ nullptr } {} /// Copy entries Log(LogInfo log_info) : m_entry_id{ 0U }, m_index{ 0U }, m_entries(log_info.number_of_entries()), m_last_entry_ptr{ nullptr } { EntryPtr entry_ptr{ log_info.log_head_ptr() }; std::vector matches(log_info.number_of_entries() >> 1); while (entry_ptr != nullptr) { assert(m_index < m_entries.size()); Entry& new_entry = m_entries[m_index]; new_entry = *entry_ptr; new_entry.m_match = nullptr; link(new_entry); if (new_entry.is_call()) { matches[new_entry.entry_id()] = m_index; } else { Entry& call_entry = m_entries[matches[new_entry.entry_id()]]; call_entry.set_match(&new_entry); } m_last_entry_ptr = &new_entry; entry_ptr = entry_ptr->next; ++m_index; } assert(m_index == m_entries.size()); assert(entry_ptr == nullptr); } EntryPtr add_call(OpPtr&& op_ptr) { assert(m_index < m_entries.size()); Entry& entry = m_entries[m_index++]; entry.set_op(std::move(op_ptr)); entry.set_entry_id(m_entry_id++); link(entry); m_last_entry_ptr = &entry; return m_last_entry_ptr; } /// \post: call_entry_ptr->is_call() EntryPtr add_ret(EntryPtr call_entry_ptr, OpPtr&& op_ptr) { assert(m_index < m_entries.size()); Entry& entry = m_entries[m_index++]; entry.set_op(std::move(op_ptr)); link(entry); m_last_entry_ptr = &entry; call_entry_ptr->set_match(m_last_entry_ptr); assert(call_entry_ptr->is_call()); assert(m_entry_id <= m_index); return m_last_entry_ptr; } EntryPtr log_head_ptr() { return &m_entries.front(); } /// Total number of call entries plus return entries. /// Returns even number since every call is paired with a return std::size_t number_of_entries() const noexcept { return m_index; } LogInfo info() { return{ log_head_ptr(), number_of_entries() }; } }; /// Output of linearizability tester /// S - sequential data type template class Result { private: friend class LinearizabilityTester; friend class LinearizabilityTester; friend class LinearizabilityTester; typedef std::vector> EntryPtrs; bool m_is_linearizable; EntryPtrs m_entry_ptrs; #ifdef _LT_DEBUG_ unsigned m_cutoff_entry_id; EntryPtr m_log_head_ptr; #endif bool m_is_timeout; double m_virtual_memory_usage; double m_resident_set_size; void reset() { m_is_linearizable = true; m_entry_ptrs.clear(); #ifdef _LT_DEBUG_ m_cutoff_entry_id = 0U; m_log_head_ptr = nullptr; #endif m_is_timeout = false; m_virtual_memory_usage = 0.0; m_resident_set_size = 0.0; } public: /// Initially linearizable Result() : m_is_linearizable{ true }, m_entry_ptrs{}, #ifdef _LT_DEBUG_ m_cutoff_entry_id{ 0U }, m_log_head_ptr{ nullptr }, #endif m_is_timeout{ false }, m_virtual_memory_usage{ 0.0 }, m_resident_set_size{ 0.0 } {} /// \pre: !is_timeout() bool is_linearizable() const noexcept { assert(!is_timeout()); return m_is_linearizable; } bool is_timeout() const noexcept { return m_is_timeout; } /// Zero if unknown, unit: MiB double virtual_memory_usage() const noexcept { return m_virtual_memory_usage; } /// Zero if unknown, unit: MiB double resident_set_size() const noexcept { return m_resident_set_size; } #ifdef _LT_DEBUG_ void debug(std::ostream& os, bool verbose = false) { os << "Linearizable: "; if (m_is_linearizable) { os << "Yes" << std::endl; for (EntryPtr entry_ptr : m_entry_ptrs) os << entry_ptr << " : " << entry_ptr->match() << std::endl; return; } os << "No" << std::endl; EntryPtr entry_ptr{ m_log_head_ptr }; for (; entry_ptr != nullptr; entry_ptr = entry_ptr->next) { os << entry_ptr << std::endl; if (entry_ptr->entry_id() == m_cutoff_entry_id) { os << "^ previous entries cannot be linearized" << std::endl; if (!(verbose || entry_ptr->is_call())) return; } } } #endif }; #ifdef _LT_TIMEOUT_ template struct Timeout { const typename Clock::time_point start_time; const typename Clock::duration max_duration; Timeout() : start_time{ Clock::now() }, max_duration{ Clock::duration::max() } {} Timeout(typename Clock::duration duration) : start_time{ Clock::now() }, max_duration{ duration } {} bool is_expired() const { return max_duration < (Clock::now() - start_time); } }; #endif /// Least-recently used cache eviction template> class LruCache { private: typedef std::list List; typedef typename List::iterator ListIterator; typedef std::unordered_map UnorderedMap; typedef typename UnorderedMap::size_type Capacity; const Capacity m_capacity; UnorderedMap m_unordered_map; List m_list; public: typedef typename UnorderedMap::iterator Iterator; LruCache() : m_capacity{ 4096 }, m_unordered_map{ m_capacity } {} LruCache(Capacity capacity) : m_capacity{ capacity }, m_unordered_map{ m_capacity } {} bool insert(Key&& key) { std::pair pair{ m_unordered_map.insert( std::make_pair(std::move(key), m_list.end())) }; if (pair.second) pair.first->second = m_list.insert(m_list.end(), pair.first->first); else m_list.splice(m_list.end(), m_list, pair.first->second); if (m_unordered_map.size() == m_capacity) { auto iter = m_unordered_map.find(m_list.front()); assert(iter != m_unordered_map.cend()); m_unordered_map.erase(iter); m_list.pop_front(); } return pair.second; } }; namespace cache { // regardless of caching, we need to keep track of the current state of type S template using State = std::pair; // if caching is enabled, we use these hash functions template class StateHash { private: // courtesy of Daniel Kroening, see CPROVER source file util/irep.cpp static inline size_t hash_rotl(std::size_t value, unsigned shift) { return (value << shift) | (value >> ((sizeof(value) * 8U) - shift)); } // courtesy of Daniel Kroening, see CPROVER source file util/irep.cpp static inline size_t hash_combine(std::size_t h1, std::size_t h2) { return hash_rotl(h1, 7U) ^ h2; } const BitsetHash m_bitset_hash; const state::Hash m_s_hash; public: StateHash() : m_bitset_hash{}, m_s_hash{} {} std::size_t operator()(const State& state) const noexcept { return hash_combine(m_bitset_hash(state.first), m_s_hash(state.second)); } }; template struct Switch { typedef std::nullptr_t Type; static bool try_insert(const S& s, const EntryPtr entry_ptr, Type& cache, Bitset& bitset) { return true; } }; template struct Switch { typedef LruCache, StateHash> Type; static bool try_insert(const S& s, const EntryPtr entry_ptr, Type& cache, Bitset& bitset) { return cache.insert(std::make_pair(bitset.immutable_set(entry_ptr->entry_id()), s)); } }; template struct Switch { typedef std::unordered_set, StateHash> Type; static bool try_insert(const S& s, const EntryPtr entry_ptr, Type& cache, Bitset& bitset) { unsigned int pos = entry_ptr->entry_id(); lt::Bitset bs = bitset.immutable_set(pos); return std::get<1>(cache.emplace(bs, s)); } }; } /// S - sequential data type template class LinearizabilityTester { private: typedef cache::Switch Cache; // Maximum number of call/ret entries, i.e. half of the // total number of entry pointers reachable in m_log_head const std::size_t m_log_size; // History to linearize, every call is matched by a return const Entry m_log_head; // Invariants: // // * for every EntryPtr `e` in `m_calls`, `e->is_call()` holds // * for every EntryPtr `e`, if `e` in `m_calls`, then `e` is not reachable // from `m_log_head` by following the next pointers. Stack m_calls; #ifdef _LT_TIMEOUT_ Timeout m_timeout; #endif // An approximation of the workload unsigned long m_number_of_iterations; // see http://stackoverflow.com/questions/669438/how-to-get-memory-usage-at-run-time-in-c // // process_mem_usage(double &, double &) - takes two doubles by reference, // attempts to read the system-dependent data for a process' virtual memory // size && resident set size, && return the results in MiB. // // On failure, returns 0.0, 0.0 static void process_mem_usage(double& vm_usage, double& resident_set) { vm_usage = resident_set = 0.0; } // Temporarily remove call_entry_ptr and call_entry_ptr->match() from the log // \pre: call_entry_ptr->is_call() static void lift(const EntryPtr call_entry_ptr) { const Entry& call = *call_entry_ptr; assert(call.is_call()); Entry& match = *call.match(); call.prev->next = call.next; call.next->prev = call.prev; match.prev->next = match.next; if (match.next != nullptr) match.next->prev = match.prev; } // Reinsert call_entry_ptr && call_entry_ptr->match() into the log // \pre: call_entry_ptr->is_call() static void unlift(const EntryPtr call_entry_ptr) { const Entry& call = *call_entry_ptr; assert(call.is_call()); Entry& match = *call.match(); assert(match.prev->next == match.next); match.prev->next = &match; if (match.next != nullptr) match.next->prev = &match; assert(call.prev->next == call.next); call.prev->next = call_entry_ptr; call.next->prev = call_entry_ptr; } void internal_check(Result& result, unsigned& global_linearized_entry_id) { S s, new_s; bool is_entry_linearizable; typename Cache::Type cache; EntryPtr pop_entry_ptr, entry_ptr{ m_log_head.next }; double virtual_memory_usage; double resident_set_size; // fixing the size is !merely an optimization but // necessary for checking the equality of bitsets Bitset linearized_entries(m_log_size); while (m_log_head.next != nullptr) { process_mem_usage(virtual_memory_usage, resident_set_size); result.m_virtual_memory_usage = std::max(result.m_virtual_memory_usage, virtual_memory_usage); result.m_resident_set_size = std::max(result.m_resident_set_size, resident_set_size); #ifdef _LT_TIMEOUT_ if (m_timeout.is_expired()) { result.m_is_timeout = true; break; } #endif ++m_number_of_iterations; assert(entry_ptr != nullptr); if (entry_ptr->is_call()) { assert(!m_calls.is_full()); assert(entry_ptr->match() != nullptr); assert(!linearized_entries.is_set(entry_ptr->entry_id())); std::tie(is_entry_linearizable, new_s) = entry_ptr->op().apply(s, entry_ptr->match()->op()); if (is_entry_linearizable && Cache::try_insert(new_s, entry_ptr, cache, linearized_entries)) { // call entry is always matched up with a return entry assert(entry_ptr->next != nullptr); // provisionally linearize the call entry together with // the associated state produced by the new linearization m_calls.push(entry_ptr, std::move(s)); s = std::move(new_s); linearized_entries.set(entry_ptr->entry_id()); // provisionally remove the call && return entry from the history lift(entry_ptr); // restart from the beginning of the shortened history entry_ptr = m_log_head.next; } else // cannot linearize call entry { // get the next entry in the unmodified history entry_ptr = entry_ptr->next; #ifdef _LT_DEBUG_ global_linearized_entry_id = std::max(global_linearized_entry_id, entry_ptr->entry_id()); #endif } } else // handle "return" entry { if (m_calls.is_empty()) break; assert(!m_calls.is_empty()); // revert state change std::tie(pop_entry_ptr, s) = m_calls.top(); assert(pop_entry_ptr != nullptr); linearized_entries.reset(pop_entry_ptr->entry_id()); m_calls.pop(); // undo the provisional linearization unlift(pop_entry_ptr); // continue after the entry to which we have just backtracked entry_ptr = pop_entry_ptr->next; } } // all call entries linearized? result.m_is_linearizable = m_calls.is_full(); assert(result.m_is_linearizable == (m_log_head.next == nullptr)); // witness linearization std::size_t pos{ 0 }; result.m_entry_ptrs.resize(m_calls.size()); for (EntryPtr& entry_ptr : result.m_entry_ptrs) entry_ptr = m_calls.entry_ptr(pos++); } public: LinearizabilityTester(LogInfo log_info) : m_log_size{ log_info.number_of_entries() >> 1 }, m_log_head{ log_info.log_head_ptr() }, m_calls{ m_log_size }, #ifdef _LT_TIMEOUT_ m_timeout{}, #endif m_number_of_iterations{} {} #ifdef _LT_TIMEOUT_ LinearizabilityTester(LogInfo log_info, std::chrono::steady_clock::duration max_duration) : m_log_size{ log_info.number_of_entries() >> 1 }, m_log_head{ log_info.log_head_ptr() }, m_calls{ m_log_size }, m_timeout{ max_duration }, m_number_of_iterations{} {} #endif /// A rough approximation of the workload unsigned long number_of_iterations() const noexcept { return m_number_of_iterations; } /// Is history linearizable? /// Throws an exception on timeout bool check() { Result result; unsigned disregard_cutoff_entry_id; internal_check(result, disregard_cutoff_entry_id); if (result.is_timeout()) throw std::runtime_error("Timeout!"); return result.is_linearizable(); } void check(Result& result) { result.reset(); #ifdef _LT_DEBUG_ internal_check(result, result.m_cutoff_entry_id); result.m_log_head_ptr = m_log_head.next; #else unsigned disregard_cutoff_entry_id; internal_check(result, disregard_cutoff_entry_id); #endif } }; template void compositional_check(Log& log, Result &result, unsigned number_of_partitions, Duration max_duration) { Slicer slicer{ log.info(), number_of_partitions }; for (unsigned partition = 0; partition < slicer.number_of_partitions; ++partition) { LinearizabilityTester tester{ slicer.sublog_info(partition), max_duration }; tester.check(result); if (!(result.is_timeout() || result.is_linearizable())) break; } } /// RAII class to ensure a thread becomes unjoinable on all paths class Thread { private: std::thread m_thread; public: Thread() : m_thread{} {} Thread(std::thread&& thread) : m_thread(std::move(thread)) {} template Thread(F&& f, Args&&... args) : m_thread(std::forward(f), std::forward(args)...) {} ~Thread() { if (m_thread.joinable()) m_thread.join(); } /// \pre: joinable() /// \post: not joinable() /// Throws std::system_error if an error occurs. void join() { m_thread.join(); } bool joinable() const noexcept { return m_thread.joinable(); } Thread& operator=(Thread&& thread) { m_thread = std::move(thread.m_thread); return *this; } }; /// Partition history into sub-histories /// A slicer partitions the history into independent sub-histories. /// Our partitioning scheme hinges on Theorem 3.6.1 in "The Art of /// Multiprocessor Programming" (Revised Ed.) by Herlihy && Shavit. /// /// Typically only associative concurrent abstract data types (ADTs) /// such as sets && hash tables are suitable for this partitioning /// scheme. && !all operations on such ADTs are always supported. /// For example, the partitioning scheme is incompatible with 0-arg /// operations such as "empty?" on sets. But it is very effective if /// we want to only check linearizability of say "insert", "remove" /// && "contains". /// /// S - sequential data type template class Slicer { private: typedef std::vector> Sublogs; static void slice(const Entry& log_head, Sublogs& sublogs) { const typename Sublogs::size_type n = sublogs.size(); EntryPtr entry_ptr{ log_head.next }, next_entry_ptr; std::vector> last_entry_ptrs(sublogs.size()); std::vector entry_ids(sublogs.size()); typename Sublogs::size_type i; unsigned new_entry_id; while (entry_ptr != nullptr) { i = entry_ptr->op().partition() % n; LogInfo& log_info = sublogs[i]; EntryPtr& last_entry_ptr = last_entry_ptrs[i]; if (log_info.log_head_ptr() == nullptr) { // initialize sub-log assert(entry_ptr->is_call()); assert(last_entry_ptr == nullptr); log_info.m_log_head_ptr = entry_ptr; log_info.m_number_of_entries = 1U; } else { // size of the sub-log increases ++log_info.m_number_of_entries; assert(last_entry_ptr != nullptr); last_entry_ptr->next = entry_ptr; } if (entry_ptr->is_call()) { new_entry_id = entry_ids[i]++; entry_ptr->set_entry_id(new_entry_id); entry_ptr->match()->set_entry_id(new_entry_id); } next_entry_ptr = entry_ptr->next; entry_ptr->prev = last_entry_ptr; entry_ptr->next = nullptr; last_entry_ptr = entry_ptr; entry_ptr = next_entry_ptr; } } Sublogs m_sublogs; unsigned m_current_partition; public: const Entry log_head; const unsigned number_of_partitions; Slicer(LogInfo log_info, unsigned _number_of_partitions) : m_sublogs(_number_of_partitions), m_current_partition{ 0U }, log_head{ log_info.log_head_ptr() }, number_of_partitions{ _number_of_partitions } { slice(log_head, m_sublogs); } const LogInfo& sublog_info(unsigned partition) const { return m_sublogs[partition]; } const LogInfo& next_sublog_info() { static LogInfo s_empty_log; unsigned partition = m_current_partition; ++m_current_partition; if (partition < number_of_partitions) return m_sublogs[partition]; return s_empty_log; } }; /// S - sequential data type template class ConcurrentLog { private: typedef std::vector> Entries; typedef typename Entries::size_type Size; Entries m_entries; std::atomic m_index; static void link(EntryPtr last_entry_ptr, Entry& entry) { if (last_entry_ptr != nullptr) last_entry_ptr->next = &entry; entry.prev = last_entry_ptr; } public: ConcurrentLog(Size capacity) : m_entries(capacity), m_index{ 0U } {} /// \remark thread-safe /// \pre: enough capacity EntryPtr push_back(OpPtr&& op_ptr) { // we use the relaxed memory || der tag because we // do !need to read any other memory locations Size index = m_index.fetch_add(1U, std::memory_order_relaxed); assert(index < m_entries.size()); // There is no data race, see [container.requirements.dataraces] // in Section 23.2.2, paragraph 2, p. 734 in the C++11 language // specification. Since the index was incremented atomically, // each thread accesses a different element in the vector. Entry& entry = m_entries[index]; entry.set_op(std::move(op_ptr)); entry.set_thread_id(std::this_thread::get_id()); return &entry; } /// \remark thread-safe /// \pre: enough capacity /// \post: call_entry_ptr->is_call() EntryPtr push_back(EntryPtr call_entry_ptr, OpPtr&& op_ptr) { EntryPtr entry_ptr = push_back(std::move(op_ptr)); call_entry_ptr->set_match(entry_ptr); assert(call_entry_ptr->is_call()); return entry_ptr; } /// \warning !thread-safe EntryPtr log_head_ptr() { if (m_entries.front().next == nullptr) { unsigned entry_id{ 0U }; Size index{ 0U }; EntryPtr last_entry_ptr{ nullptr }; for (Entry& entry : m_entries) { if (index == m_index) break; ++index; if (entry.is_call()) { entry.set_entry_id(entry_id); entry.match()->set_entry_id(entry_id); ++entry_id; } link(last_entry_ptr, entry); last_entry_ptr = &entry; } } return &m_entries.front(); } /// Total number of call entries plus return entries. /// Returns even number since every call is paired with a return /// /// \warning !thread-safe std::size_t number_of_entries() const noexcept { return m_index.load(); } /// \warning !thread-safe LogInfo info() { return{ log_head_ptr(), number_of_entries() }; } }; /************* Models for sequential abstract data types *************/ class FlexibleBitset { public: typedef Bitset::Pos Pos; private: Bitset m_bitset; void allocate_blocks_if_neccessary(Pos pos) noexcept { if (pos < Bitset::s_bits_per_block) return; assert(0U < pos); Bitset::BlockIndex new_size{ Bitset::blocks_size(pos) }; if (m_bitset.m_blocks.size() < new_size) { m_bitset.m_blocks.resize(new_size); } } public: FlexibleBitset() : m_bitset{ 1U } {} FlexibleBitset(Pos max_pos) : m_bitset{ max_pos } {} bool is_empty() const noexcept { return m_bitset.is_empty(); } bool set(Pos pos) { allocate_blocks_if_neccessary(pos); return m_bitset.set(pos); } bool is_set(Pos pos) const { return m_bitset.is_set(pos); } bool reset(Pos pos) { allocate_blocks_if_neccessary(pos); return m_bitset.reset(pos); } /// Same size && bits? bool operator==(const FlexibleBitset& other) const noexcept { return m_bitset == other.m_bitset; } bool operator!=(const FlexibleBitset& other) const noexcept { return m_bitset != other.m_bitset; } std::size_t hash_code() const noexcept { return m_bitset.m_hash; } }; namespace state { namespace internal { template struct RetOp : public Op { typedef RetOp Base; const Ret ret; RetOp(Ret r) : Op(), ret{ r } {} RetOp(Ret r, unsigned partition) : Op(partition), ret{ r } {} #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { return os << "ret: " << ret; } #endif }; template struct ZeroArgOp : public Op { typedef ZeroArgOp Base; ZeroArgOp() : Op() {} #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { return os << op_name << "()"; } #endif }; template struct ArgOp : public Op { typedef ArgOp Base; const Value value; ArgOp(Value v) : Op(v), value{ v } {} ArgOp(bool is_partitionable, Value v) : Op(is_partitionable, v), value{ v } {} #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { return os << op_name << "(" << std::to_string(value) << ")"; } #endif }; } /// Byte read-write register with CAS class Atomic { public: typedef signed char Value; private: static constexpr char s_read_op_name[5] = "read"; static constexpr char s_write_op_name[6] = "write"; struct ReadRetOp : public Op { private: const bool m_is_pending; const Value m_value; public: ReadRetOp(bool is_pending, Value value) : Op(), m_is_pending(is_pending), m_value{ value } {} bool is_pending() const noexcept { return m_is_pending; } /// \pre: !is_pending() Value value() const { assert(!m_is_pending); return m_value; } #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { if (m_is_pending) return os << "read() : pending"; return os << "read() : " << std::to_string(m_value); } #endif }; struct ReadCallOp : public internal::ZeroArgOp { ReadCallOp() : Base() {} std::pair internal_apply(const Atomic& atomic, const Op& op) override { const ReadRetOp& read_ret = dynamic_cast(op); if (read_ret.is_pending()) return{ true, atomic }; return{ atomic.get() == read_ret.value(), atomic }; } }; struct CASRetOp : public Op { private: // 0: pending, 1: failed, 2: ok const unsigned m_status; public: CASRetOp(unsigned status) : Op(), m_status(status) {} bool is_pending() const noexcept { return m_status == 0U; } /// \pre: !is_pending() bool is_ok() const { assert(0U < m_status); return m_status == 2U; } #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { os << "cas() : "; if (is_pending()) return os << "pending"; if (is_ok()) return os << "succeeded"; return os << "failed"; } #endif }; struct CASCallOp : public Op { const Value current_value, new_value; CASCallOp(Value current_v, Value new_v) : Op(), current_value{ current_v }, new_value{ new_v } {} #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { return os << "cas(" << std::to_string(current_value) << ", " << std::to_string(new_value) << ")"; } #endif std::pair internal_apply(const Atomic& atomic, const Op& op) override { const CASRetOp& cas_ret = dynamic_cast(op); if (cas_ret.is_pending()) { if (atomic.get() == current_value) return{ true, atomic.set(new_value) }; return{ true, atomic }; } if (atomic.get() == current_value) return{ cas_ret.is_ok(), atomic.set(new_value) }; return{ !cas_ret.is_ok(), atomic }; } }; struct WriteRetOp : public Op { const bool is_pending; WriteRetOp(bool pending) : Op(), is_pending(pending) {} #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { if (is_pending) return os << "write() : pending"; return os << "write() : succeeded"; } #endif }; struct WriteCallOp : public internal::ArgOp { typedef internal::ArgOp Base; WriteCallOp(Value new_value) : Base(false, new_value) {} std::pair internal_apply(const Atomic& atomic, const Op& op) override { const WriteRetOp& write_ret = dynamic_cast(op); // we don't need to check write_ret.is_pending because if the // write is pending then it could be still linearized last return{ true, atomic.set(Base::value) }; } }; Value m_value; Atomic(Value value) : m_value{ value } {} public: typedef std::unique_ptr> AtomicOpPtr; static AtomicOpPtr make_read_call() { return make_unique(); } static AtomicOpPtr make_read_ret(Value v) { return make_unique(false, v); } static AtomicOpPtr make_read_pending() { return make_unique(true, '\0'); } static AtomicOpPtr make_write_call(Value v) { return make_unique(v); } static AtomicOpPtr make_write_ret() { return make_unique(false); } static AtomicOpPtr make_write_pending() { return make_unique(true); } static AtomicOpPtr make_cas_call(Value curr_value, Value new_value) { return make_unique(curr_value, new_value); } static AtomicOpPtr make_cas_ret(bool ok) { return make_unique(1U + ok); } static AtomicOpPtr make_cas_pending() { return make_unique(0U); } /// Initially, register is negative Atomic() : m_value{ -1 } {} Value get() const noexcept { return m_value; } Atomic set(Value v) const noexcept { return{ v }; } bool operator==(const Atomic& atomic) const { return m_value == atomic.m_value; } bool operator!=(const Atomic& atomic) const { return m_value != atomic.m_value; } }; constexpr char Atomic::s_read_op_name[]; constexpr char Atomic::s_write_op_name[]; template<> struct Hash { std::size_t operator()(const Atomic& atomic) const noexcept { return atomic.get() * 193U; } }; class Set { public: typedef char Value; typedef bool Ret; private: static constexpr char s_empty_op_name[6] = "empty"; static constexpr char s_contains_op_name[9] = "contains"; static constexpr char s_insert_op_name[7] = "insert"; static constexpr char s_erase_op_name[6] = "erase"; public: struct RetOp : public internal::RetOp { RetOp(Ret r) : Base(r) {} }; struct EmptyCallOp : public internal::ZeroArgOp { EmptyCallOp() : Base() {} std::pair internal_apply(const Set& set, const Op& op) override { const RetOp& empty_ret = dynamic_cast(op); bool ret = set.is_empty(); return{ ret == empty_ret.ret, set }; } }; struct ContainsCallOp : public internal::ArgOp { ContainsCallOp(Value v) : Base(v) {} std::pair internal_apply(const Set& set, const Op& op) override { const RetOp& contains_ret = dynamic_cast(op); bool ret = set.contains(value); return{ ret == contains_ret.ret, set }; } }; struct InsertCallOp : public internal::ArgOp { InsertCallOp(Value v) : Base(v) {} std::pair internal_apply(const Set& set, const Op& op) override { bool ret; Set new_set; const RetOp& insert_ret = dynamic_cast(op); std::tie(ret, new_set) = set.insert(value); return{ ret == insert_ret.ret, std::move(new_set) }; } }; struct EraseCallOp : public internal::ArgOp { EraseCallOp(Value v) : Base(v) {} std::pair internal_apply(const Set& set, const Op& op) override { bool ret; Set new_set; const RetOp& erase_ret = dynamic_cast(op); std::tie(ret, new_set) = set.erase(value); return{ ret == erase_ret.ret, std::move(new_set) }; } }; typedef std::unique_ptr> SetOpPtr; FlexibleBitset m_bitset; Set(FlexibleBitset&& bitset) : m_bitset(std::move(bitset)) {} public: static SetOpPtr make_empty_call() { return make_unique(); } static SetOpPtr make_contains_call(Value value) { return make_unique(value); } static SetOpPtr make_insert_call(Value value) { return make_unique(value); } static SetOpPtr make_erase_call(Value value) { return make_unique(value); } static SetOpPtr make_ret(Ret ret) { return make_unique(ret); } Set() : m_bitset{} {} const FlexibleBitset& bitset() const { return m_bitset; } bool is_empty() const { return m_bitset.is_empty(); } bool contains(const Value& value) const { return m_bitset.is_set(value); } std::pair insert(const Value& value) const { FlexibleBitset copy_bitset{ m_bitset }; bool ok = copy_bitset.set(value); return{ ok, Set(std::move(copy_bitset)) }; } std::pair erase(const Value& value) const { FlexibleBitset copy_bitset{ m_bitset }; bool ok = copy_bitset.reset(value); return{ ok, Set(std::move(copy_bitset)) }; } bool operator==(const Set& set) const { return m_bitset == set.m_bitset; } bool operator!=(const Set& set) const { return m_bitset != set.m_bitset; } }; constexpr char Set::s_empty_op_name[]; constexpr char Set::s_contains_op_name[]; constexpr char Set::s_insert_op_name[]; constexpr char Set::s_erase_op_name[]; template<> struct Hash { std::size_t operator()(const Set& set) const noexcept { return set.bitset().hash_code(); } }; /// Bounded stack /// N - stack capacity template class Stack { public: typedef char Value; private: static constexpr char s_try_push_op_name[9] = "try_push"; static constexpr char s_try_pop_op_name[8] = "try_pop"; public: struct TryPushCallOp : public internal::ArgOp, Value, s_try_push_op_name> { typedef internal::ArgOp, Value, s_try_push_op_name> Base; TryPushCallOp(Value v) : Base(false, v) {} std::pair> internal_apply(const Stack& stack, const Op>& op) override { typedef internal::RetOp, bool> RetOp; const RetOp& try_push_ret = dynamic_cast(op); if (!stack.is_full()) return{ try_push_ret.ret, stack.push(Base::value) }; return{ !try_push_ret.ret, stack }; } }; struct TryPopRetOp : public Op> { private: const bool m_ok; const Value m_value; public: TryPopRetOp(bool ok, Value value) : Op>(), m_ok{ ok }, m_value{ value } {} TryPopRetOp(bool ok, std::size_t height, Value value) : Op>(height), m_ok{ ok }, m_value{ value } {} bool ok() const { return m_ok; } /// \pre: ok() Value value() const { assert(ok()); return m_value; } #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { return os << "ret: [ok: " << ok() << ", value: " << (ok() ? std::to_string(value()) : "undefined") << "]"; } #endif }; struct TryPopCallOp : public internal::ZeroArgOp, s_try_pop_op_name> { typedef internal::ZeroArgOp, s_try_pop_op_name> Base; TryPopCallOp() : Base() {} std::pair> internal_apply(const Stack& stack, const Op>& op) override { const TryPopRetOp& try_pop_ret = dynamic_cast(op); if (stack.is_empty()) return{ !try_pop_ret.ok(), stack }; Value value{ stack.top() }; return{ try_pop_ret.ok() && value == try_pop_ret.value(), stack.pop() }; } }; typedef std::unique_ptr>> StackOpPtr; class Node; typedef Node* NodePtr; /// Version tree of stacks class Node { private: friend class Stack; // if m_prev is null, then m_size is zero const std::size_t m_size; // top of stack is defined if m_prev != nullptr const Value m_top; const NodePtr m_prev; unsigned m_ref_counter; std::vector m_vector; public: ~Node() { if (m_prev == nullptr) return; m_prev->m_vector[m_top] = nullptr; if (--m_prev->m_ref_counter == 0) delete m_prev; } Node(const Node&) = delete; Node& operator=(const Node&) = delete; Node() : m_size{ 0 }, m_top{}, m_prev{ nullptr }, m_ref_counter{ 0U }, m_vector{} {} /// \pre: prev != nullptr Node(std::size_t size, Value value, const NodePtr& prev) : m_size{ size }, m_top{ value }, m_prev{ prev }, m_ref_counter{ 0U }, m_vector{} { assert(prev != nullptr); ++prev->m_ref_counter; } /// Returns non-null pointer /// \pre: prev != nullptr NodePtr get_or_update_next(Value value, NodePtr& prev) { assert(prev != nullptr); if (m_vector.size() <= value) m_vector.resize(value + 1U); assert(value < m_vector.size()); NodePtr& node_ptr = m_vector[value]; if (node_ptr == nullptr) node_ptr = new Node(prev->size() + 1U, value, prev); assert(node_ptr != nullptr); assert(node_ptr->m_top == value); return node_ptr; } std::size_t size() const { assert(m_prev != nullptr || m_size == 0); return m_size; } const NodePtr& prev() const { return m_prev; } /// Defined if prev() != nullptr Value top() const noexcept { return m_top; } }; public: static StackOpPtr make_try_push_call(Value value) { return make_unique(value); } static StackOpPtr make_try_push_ret(bool ok) { typedef internal::RetOp, bool> RetOp; return make_unique(ok); } static StackOpPtr make_try_push_ret(bool ok, std::size_t height) { typedef internal::RetOp, bool> RetOp; return make_unique(ok, height); } static StackOpPtr make_try_pop_call() { return make_unique(); } static StackOpPtr make_try_pop_ret(bool ok, Value v) { return make_unique(ok, v); } static StackOpPtr make_try_pop_ret(bool ok, std::size_t height, Value v) { return make_unique(ok, height, v); } private: // never null, m_curr->size() <= N mutable NodePtr m_curr; void inc_ref_counter() const noexcept { if (m_curr != nullptr) ++m_curr->m_ref_counter; } void dec_ref_counter() const { assert(m_curr == nullptr || 0 < m_curr->m_ref_counter); if (m_curr != nullptr && --m_curr->m_ref_counter == 0) delete m_curr; } Stack(NodePtr curr) : m_curr{ curr } { inc_ref_counter(); } public: ~Stack() { dec_ref_counter(); } Stack(const Stack& other) : m_curr{ other.m_curr } { inc_ref_counter(); } Stack(Stack&& other) : m_curr{ other.m_curr } { other.m_curr = nullptr; } Stack& operator=(const Stack& other) { dec_ref_counter(); m_curr = other.m_curr; inc_ref_counter(); return *this; } Stack& operator=(Stack&& other) { dec_ref_counter(); m_curr = other.m_curr; other.m_curr = nullptr; return *this; } Stack() : m_curr{ new Node() } { inc_ref_counter(); } bool is_empty() const { return m_curr->prev() == nullptr; } bool is_full() const { return m_curr->size() == N; } Stack push(const Value& value) const { assert(!is_full()); return{ m_curr->get_or_update_next(value, m_curr) }; } /// \pre: !is_empty() Stack pop() const { assert(!is_empty()); return{ m_curr->prev() }; } Value top() const { assert(!is_empty()); return m_curr->top(); } bool operator==(const Stack& stack) const { return stack.m_curr == m_curr; } bool operator!=(const Stack& stack) const { return stack.m_curr != m_curr; } std::size_t hash_code() const { // On many platforms (except systems with segmented addressing) // std::size_t is synonymous with std::uintptr_t. // // \see_also http://en.cppreference.com/w/cpp/types/size_t return reinterpret_cast(m_curr); } }; /// Bounded queue /// N - queue capacity template class Queue { public: typedef char Value; private: static constexpr char s_try_enqueue_op_name[12] = "try_enqueue"; static constexpr char s_try_dequeue_op_name[12] = "try_dequeue"; public: struct TryEnqueueCallOp : public internal::ArgOp, Value, s_try_enqueue_op_name> { typedef internal::ArgOp, Value, s_try_enqueue_op_name> Base; TryEnqueueCallOp(Value v) : Base(false, v) {} std::pair> internal_apply(const Queue& queue, const Op>& op) override { typedef internal::RetOp, bool> RetOp; const RetOp& try_enqueue_ret = dynamic_cast(op); if (!queue.is_full()) return{ try_enqueue_ret.ret, queue.enqueue(Base::value) }; return{ !try_enqueue_ret.ret, queue }; } }; struct TryDequeueRetOp : public Op> { private: const bool m_ok; const Value m_value; public: TryDequeueRetOp(bool ok, Value value) : Op>(), m_ok{ ok }, m_value{ value } {} TryDequeueRetOp(bool ok, std::size_t height, Value value) : Op>(height), m_ok{ ok }, m_value{ value } {} bool ok() const { return m_ok; } /// \pre: ok() Value value() const { assert(ok()); return m_value; } #ifdef _LT_DEBUG_ std::ostream& print(std::ostream& os) const override { return os << "ret: [ok: " << ok() << ", value: " << (ok() ? std::to_string(value()) : "undefined") << "]"; } #endif }; struct TryDequeueCallOp : public internal::ZeroArgOp, s_try_dequeue_op_name> { typedef internal::ZeroArgOp, s_try_dequeue_op_name> Base; TryDequeueCallOp() : Base() {} std::pair> internal_apply(const Queue& queue, const Op>& op) override { const TryDequeueRetOp& try_dequeue_ret = dynamic_cast(op); if (queue.is_empty()) return{ !try_dequeue_ret.ok(), queue }; Value value{ queue.get_value() }; return{ try_dequeue_ret.ok() && value == try_dequeue_ret.value(), queue.dequeue() }; } }; typedef std::unique_ptr>> QueueOpPtr; class Node; typedef Node* NodePtr; class Node { private: friend class Queue; // value of current node const Value m_value; // pointers to next and prev objects in the queue, possibly null NodePtr m_next; NodePtr m_prev; // number of next elements from the current node. The pointer m_next // points only at the last successor added. When m_nexts_num != 0, it // is necessary to traverse the queue starting from the tail to find the // corresponding successor at the given node. // Example: // a <--> b <--> c <-- d <--> e // <--> f <--> g // In the example c.m_nexts points to f. In order to find the successor of // c for the queue with head = a and tail = e the queue must be traversed // from e until the point with multiple successors. unsigned m_nexts_num; // number of references to the current node (necessary for garbage collection) unsigned m_ref_counter; public: ~Node() { if (m_prev != nullptr) { if (m_prev->m_next == this) m_prev->m_next = nullptr; } if (m_next != nullptr) { m_next->m_prev = nullptr; } } Node(const Node&) = delete; Node& operator=(const Node&) = delete; Node() : m_value{}, m_next{ nullptr }, m_prev{ nullptr }, m_ref_counter{ 0U }, m_nexts_num{ 0U } {} /// \pre: prev != nullptr Node(Value value, const NodePtr& prev, const NodePtr& next) : m_value{ value }, m_prev{ prev }, m_next{ next }, m_ref_counter{ 0U }, m_nexts_num{ 0U } { if (prev != nullptr) { prev->m_ref_counter++; } if (next != nullptr) { next->m_ref_counter++; } } NodePtr update_next(Value value) { /* if (m_nexts_num > 0 && m_next != nullptr) { m_next->m_ref_counter--; } */ NodePtr node_ptr = new Node(value, this, nullptr); m_next = node_ptr; node_ptr->m_ref_counter++; m_nexts_num++; return node_ptr; } const NodePtr& next() const { return m_next; } const NodePtr& prev() const { return m_prev; } Value value() const noexcept { return m_value; } }; public: static QueueOpPtr make_try_enqueue_call(Value value) { return make_unique(value); } static QueueOpPtr make_try_enqueue_ret(bool ok) { typedef internal::RetOp, bool> RetOp; return make_unique(ok); } static QueueOpPtr make_try_enqueue_ret(bool ok, std::size_t height) { typedef internal::RetOp, bool> RetOp; return make_unique(ok, height); } static QueueOpPtr make_try_dequeue_call() { return make_unique(); } static QueueOpPtr make_try_dequeue_ret(bool ok, Value v) { return make_unique(ok, v); } static QueueOpPtr make_try_dequeue_ret(bool ok, std::size_t height, Value v) { return make_unique(ok, height, v); } private: // m_head points to the element BEFORE the actual head NodePtr m_head; NodePtr m_tail; size_t m_size; Queue(NodePtr head, NodePtr tail, size_t size) : m_head{ head }, m_tail{ tail }, m_size{ size } { inc_ref_counter(); } // Decrement reference counter of head and tail, delete them if necessary void dec_ref_counter() const { NodePtr curNode = m_head; NodePtr aux = nullptr; if (m_head != nullptr && m_tail != nullptr) { m_head->m_ref_counter--; m_tail->m_ref_counter--; } while (curNode != nullptr && curNode->prev() != m_tail && curNode->m_ref_counter <= 1){ aux = curNode; if (curNode->m_nexts_num <= 1) curNode = curNode->next(); else curNode = find_next(curNode); if (curNode != nullptr && curNode == aux->next()) curNode->m_ref_counter--; delete aux; } if (aux == m_tail) { return; } curNode = m_tail; while (curNode != nullptr && curNode->next() != m_head && curNode->m_ref_counter <= 1){ aux = curNode; curNode = curNode->prev(); if (curNode != nullptr) { /*if (curNode->next() != aux) { if (aux->m_ref_counter == 1) { break; } }*/ --curNode->m_ref_counter; } delete aux; } } // Find the successor of a specific node NodePtr find_next(NodePtr node) const { if (node == m_tail) { return nullptr; } NodePtr curr = m_tail; while (curr != nullptr && curr->prev() != node) { curr = curr->prev(); } return curr; } // Increment reference counter of head and tail void inc_ref_counter() const { if (m_head != nullptr) m_head->m_ref_counter++; if (m_tail != nullptr) m_tail->m_ref_counter++; } // Used when m_head has more than one successor to recover the direction in which to // dequeue NodePtr find_next() const { return find_next(m_head); } public: ~Queue() { dec_ref_counter(); } Queue(const Queue& other) : m_head{ other.m_head }, m_tail{ other.m_tail }, m_size{ other.m_size } { inc_ref_counter(); } Queue(Queue&& other) : m_head{ other.m_head }, m_tail{ other.m_tail }, m_size{ other.m_size } { other.m_head = nullptr; other.m_tail = nullptr; other.m_size = 0U; } Queue& operator=(const Queue& other) { dec_ref_counter(); m_head = other.m_head; m_tail = other.m_tail; m_size = other.m_size; inc_ref_counter(); return *this; } Queue& operator=(Queue&& other) { dec_ref_counter(); m_size = other.m_size; m_head = other.m_head; m_tail = other.m_tail; other.m_head = nullptr; other.m_tail = nullptr; other.m_size = 0U; return *this; } Queue() { NodePtr newNode = new Node(); m_head = newNode; m_tail = newNode; m_size = 0U; inc_ref_counter(); } bool is_empty() const { return m_size == 0U; } bool is_full() const { return m_size == N; } // If enqueing is possible returns the updated stack, otherwise returns current stack. Queue enqueue(const Value& value) const { if (!is_full()) { return{ m_head, m_tail->update_next(value), m_size + 1 }; } return *this; } // If dequeing is possible returns the updated stack, otherwise returns current stack. // In case of multiple successors we have to check which is the right one starting // from the tail. Queue dequeue() const { if (!is_empty()) { if (m_head->m_nexts_num <= 1) { return{ m_head->next(), m_tail, m_size - 1 }; } else { return{ find_next(), m_tail, m_size - 1 }; } } return *this; } // Returns the first value of the queue i.e. the value stored in the successor of m_head. // If head has more than one successor the correct one must be retrieved Value get_value() const { assert(!is_empty()); assert(m_head != nullptr); if (m_head->m_nexts_num != 1) return find_next()->value(); return m_head->m_next->value(); } bool operator==(const Queue& queue) const { return (queue.m_head == m_head && queue.m_tail == m_tail && queue.m_size == m_size); } bool operator!=(const Queue& queue) const { return !(*this == queue); } std::size_t hash_code() const { // On many platforms (except systems with segmented addressing) // std::size_t is synonymous with std::uintptr_t. // // \see_also http://en.cppreference.com/w/cpp/types/size_t return reinterpret_cast(m_head); } }; template constexpr char Stack::s_try_push_op_name[]; template constexpr char Stack::s_try_pop_op_name[]; template struct Hash> { std::size_t operator()(const Stack& stack) const noexcept { return stack.hash_code(); } }; template constexpr char Queue::s_try_enqueue_op_name[]; template constexpr char Queue::s_try_dequeue_op_name[]; template struct Hash> { std::size_t operator()(const Queue& queue) const noexcept { return queue.hash_code(); } }; } } /************* Unit tests && experiments *************/ using namespace lt; static void test_lru_cache() { LruCache lru_cache{ 3 }; assert(lru_cache.insert('\1')); assert(!lru_cache.insert('\1')); assert(lru_cache.insert('\2')); assert(lru_cache.insert('\3')); assert(lru_cache.insert('\1')); assert(!lru_cache.insert('\3')); assert(lru_cache.insert('\4')); assert(lru_cache.insert('\1')); } static void test_atomic_op() { bool ok; state::Atomic atomic, new_atomic; OpPtr read_call_op_ptr; OpPtr read_0_ret_op_ptr, read_0_pending_op_ptr; OpPtr read_1_ret_op_ptr; OpPtr read_2_ret_op_ptr; OpPtr write_1_call_op_ptr, write_1_ret_op_ptr, write_1_pending_op_ptr; OpPtr cas_2_succeeded_call_op_ptr, cas_2_succeeded_ret_op_ptr, cas_2_pending_op_ptr; OpPtr cas_2_failed_call_op_ptr, cas_2_failed_ret_op_ptr; read_call_op_ptr = state::Atomic::make_read_call(); read_0_ret_op_ptr = state::Atomic::make_read_ret('\0'); read_0_pending_op_ptr = state::Atomic::make_read_pending(); read_1_ret_op_ptr = state::Atomic::make_read_ret('\1'); read_2_ret_op_ptr = state::Atomic::make_read_ret('\2'); write_1_call_op_ptr = state::Atomic::make_write_call('\1'); write_1_ret_op_ptr = state::Atomic::make_write_ret(); write_1_pending_op_ptr = state::Atomic::make_write_pending(); cas_2_succeeded_call_op_ptr = state::Atomic::make_cas_call('\1', '\2'); cas_2_succeeded_ret_op_ptr = state::Atomic::make_cas_ret(true); cas_2_pending_op_ptr = state::Atomic::make_cas_pending(); cas_2_failed_call_op_ptr = state::Atomic::make_cas_call('\2', '\1'); cas_2_failed_ret_op_ptr = state::Atomic::make_cas_ret(false); Op& read_call_op = *read_call_op_ptr; Op& read_0_ret_op = *read_0_ret_op_ptr; Op& read_0_pending_op = *read_0_pending_op_ptr; Op& read_1_ret_op = *read_1_ret_op_ptr; Op& read_2_ret_op = *read_2_ret_op_ptr; Op& write_1_call_op = *write_1_call_op_ptr; Op& write_1_ret_op = *write_1_ret_op_ptr; Op& write_1_pending_op = *write_1_pending_op_ptr; Op& cas_2_succeeded_call_op = *cas_2_succeeded_call_op_ptr; Op& cas_2_succeeded_ret_op = *cas_2_succeeded_ret_op_ptr; Op& cas_2_pending_op = *cas_2_pending_op_ptr; Op& cas_2_failed_call_op = *cas_2_failed_call_op_ptr; Op& cas_2_failed_ret_op = *cas_2_failed_ret_op_ptr; assert(!read_call_op.is_partitionable()); assert(!read_0_ret_op.is_partitionable()); assert(!read_0_pending_op.is_partitionable()); assert(!read_1_ret_op.is_partitionable()); assert(!read_2_ret_op.is_partitionable()); assert(!write_1_call_op.is_partitionable()); assert(!write_1_ret_op.is_partitionable()); assert(!write_1_pending_op.is_partitionable()); assert(!cas_2_succeeded_call_op.is_partitionable()); assert(!cas_2_succeeded_ret_op.is_partitionable()); assert(!cas_2_pending_op.is_partitionable()); assert(!cas_2_failed_call_op.is_partitionable()); assert(!cas_2_failed_ret_op.is_partitionable()); std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_0_ret_op); assert(atomic == new_atomic); assert(!ok); std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_1_ret_op); assert(atomic == new_atomic); assert(!ok); std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_0_pending_op); assert(atomic == new_atomic); assert(ok); std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_1_ret_op); assert(atomic == new_atomic); assert(!ok); std::tie(ok, new_atomic) = write_1_call_op.apply(atomic, write_1_pending_op); assert(atomic != new_atomic); assert(ok); std::tie(ok, new_atomic) = write_1_call_op.apply(atomic, write_1_ret_op); assert(atomic != new_atomic); assert(ok); atomic = new_atomic; std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_1_ret_op); assert(atomic == new_atomic); assert(ok); std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_2_ret_op); assert(atomic == new_atomic); assert(!ok); std::tie(ok, new_atomic) = cas_2_failed_call_op.apply(atomic, cas_2_failed_ret_op); assert(atomic == new_atomic); assert(ok); std::tie(ok, new_atomic) = cas_2_failed_call_op.apply(atomic, cas_2_succeeded_ret_op); assert(atomic == new_atomic); assert(!ok); std::tie(ok, new_atomic) = cas_2_succeeded_call_op.apply(atomic, cas_2_pending_op); assert(atomic != new_atomic); assert(ok); std::tie(ok, new_atomic) = cas_2_succeeded_call_op.apply(atomic, cas_2_succeeded_ret_op); assert(atomic != new_atomic); assert(ok); atomic = new_atomic; std::tie(ok, new_atomic) = read_call_op.apply(atomic, read_2_ret_op); assert(atomic == new_atomic); assert(ok); } /// a few sanity checks static void test_stack() { Entry ret, call; call.set_op(state::Set::make_contains_call('\1')); ret.set_op(state::Set::make_ret(true)); call.set_match(&ret); EntryPtr A{ &call }, B{ &call }, C{ &call }; Stack stack{ 3 }; assert(stack.is_empty()); assert(!stack.is_full()); assert(stack.size() == 0U); stack.push(A, state::Set()); assert(std::get<0>(stack.top()) == A); assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.size() == 1U); stack.push(B, state::Set()); assert(std::get<0>(stack.top()) == B); assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.size() == 2U); stack.push(C, state::Set()); assert(std::get<0>(stack.top()) == C); assert(!stack.is_empty()); assert(stack.is_full()); assert(stack.size() == 3U); stack.pop(); assert(std::get<0>(stack.top()) == B); assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.size() == 2U); stack.push(C, state::Set()); assert(std::get<0>(stack.top()) == C); assert(!stack.is_empty()); assert(stack.is_full()); assert(stack.size() == 3U); // pop multiple entries at once stack.pop(2); assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.size() == 1U); stack.pop(); assert(stack.is_empty()); assert(!stack.is_full()); assert(stack.size() == 0U); } static void test_bitset() { constexpr unsigned bits_per_block = static_cast(sizeof(unsigned long) * CHAR_BIT); constexpr unsigned N = bits_per_block + 7; FlexibleBitset bitset; for (unsigned k{ 0U }; k < N; ++k) assert(!bitset.is_set(k)); assert(bitset.is_empty()); bitset.set(0); assert(bitset.is_set(0)); assert(!bitset.is_empty()); for (unsigned k{ 1U }; k < N; ++k) assert(!bitset.is_set(k)); bitset.reset(0); assert(!bitset.is_set(0)); assert(bitset.is_empty()); bitset.set(1); assert(!bitset.is_set(0)); assert(bitset.is_set(1)); assert(!bitset.is_empty()); for (unsigned k{ 2U }; k < N; ++k) assert(!bitset.is_set(k)); bitset.set(N-1); assert(bitset.is_set(N-1)); assert(!bitset.is_empty()); for (unsigned k{ 2U }; k < N - 1U; ++k) assert(!bitset.is_set(k)); FlexibleBitset another_bitset; another_bitset.set(1); another_bitset.set(N-1); FlexibleBitset yet_another_bitset(another_bitset); assert(bitset == another_bitset); assert(bitset == yet_another_bitset); assert(!bitset.is_set(bits_per_block - 1U)); assert(bitset.set(bits_per_block - 1U)); assert(bitset.is_set(bits_per_block - 1U)); assert(!bitset.is_set(bits_per_block)); assert(bitset.set(bits_per_block)); assert(bitset.is_set(bits_per_block)); assert(!bitset.is_set(bits_per_block + 1U)); assert(bitset.set(bits_per_block + 1U)); assert(bitset.is_set(bits_per_block + 1U)); assert(!bitset.is_set(2U * bits_per_block - 1U)); assert(bitset.set(2U * bits_per_block - 1U)); assert(bitset.is_set(2U * bits_per_block - 1U)); assert(!bitset.is_set(2U * bits_per_block)); assert(bitset.set(2U * bits_per_block)); assert(bitset.is_set(2U * bits_per_block)); assert(!bitset.is_set(2U * bits_per_block + 1U)); assert(bitset.set(2U * bits_per_block + 1U)); assert(bitset.is_set(2U * bits_per_block + 1U)); bitset = another_bitset; assert(bitset.set(2U * bits_per_block - 1U)); assert(bitset.reset(2U * bits_per_block - 1U)); assert(bitset == another_bitset); assert(bitset.set(2U * bits_per_block)); assert(bitset.reset(2U * bits_per_block)); // different number of blocks assert(bitset != another_bitset); assert(bitset.set(2U * bits_per_block + 1U)); assert(bitset.reset(2U * bits_per_block + 1U)); // different number of blocks assert(bitset != another_bitset); } static void test_state_set() { bool ok; state::Set set; assert(!set.contains('\1')); std::tie(ok, set) = set.insert('\1'); assert(ok); assert(set.contains('\1')); // item is already in the set std::tie(ok, set) = set.insert('\1'); assert(!ok); assert(set.contains('\1')); std::tie(ok, set) = set.erase('\1'); assert(ok); assert(!set.contains('\1')); // item has been already erased from the set std::tie(ok, set) = set.erase('\1'); assert(!ok); assert(!set.contains('\1')); } static void test_state_set_op() { bool ok; state::Set set, new_set; OpPtr empty_op_ptr; OpPtr contains_op_ptr; OpPtr insert_op_ptr; OpPtr erase_op_ptr; OpPtr true_ret_op_ptr{ state::Set::make_ret(true) }; OpPtr false_ret_op_ptr{ state::Set::make_ret(false) }; const Op& true_ret_op = *true_ret_op_ptr; const Op& false_ret_op = *false_ret_op_ptr; empty_op_ptr = state::Set::make_empty_call(); contains_op_ptr = state::Set::make_contains_call('\1'); insert_op_ptr = state::Set::make_insert_call('\1'); erase_op_ptr = state::Set::make_erase_call('\1'); Op& empty_op = *empty_op_ptr; Op& contains_op = *contains_op_ptr; Op& insert_op = *insert_op_ptr; Op& erase_op = *erase_op_ptr; std::tie(ok, new_set) = empty_op.apply(set, true_ret_op); assert(set == new_set); assert(ok); std::tie(ok, new_set) = contains_op.apply(set, false_ret_op); assert(set == new_set); assert(ok); std::tie(ok, new_set) = insert_op.apply(set, true_ret_op); assert(set != new_set); assert(ok); set = new_set; std::tie(ok, new_set) = empty_op.apply(set, false_ret_op); assert(set == new_set); assert(ok); std::tie(ok, new_set) = contains_op.apply(set, true_ret_op); assert(set == new_set); assert(ok); // item is already in the set, so insertion is unsuccessful std::tie(ok, new_set) = insert_op.apply(set, false_ret_op); assert(set == new_set); assert(ok); std::tie(ok, new_set) = contains_op.apply(set, true_ret_op); assert(set == new_set); assert(ok); std::tie(ok, new_set) = erase_op.apply(set, true_ret_op); assert(set != new_set); assert(ok); assert(std::get<0>(contains_op.apply(set, true_ret_op))); assert(!std::get<0>(contains_op.apply(set, false_ret_op))); assert(!std::get<0>(contains_op.apply(new_set, true_ret_op))); assert(std::get<0>(contains_op.apply(new_set, false_ret_op))); } static void test_state_stack() { constexpr unsigned N = 2; state::Stack stack; state::Stack new_stack; state::Stack stack_1, stack_2; assert(stack.is_empty()); assert(!stack.is_full()); new_stack = stack.push('\1'); assert(stack != new_stack); stack = stack_1 = new_stack; assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.top() == '\1'); new_stack = stack.push('\2'); assert(stack != new_stack); stack = stack_2 = new_stack; assert(stack_1 != stack_2); assert(!stack.is_empty()); assert(stack.is_full()); assert(stack.top() == '\2'); new_stack = stack.pop(); assert(new_stack == stack_1); stack = new_stack; assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.top() == '\1'); new_stack = stack.push('\2'); assert(stack != new_stack); assert(new_stack == stack_2); stack = new_stack; assert(!stack.is_empty()); assert(stack.is_full()); assert(stack.top() == '\2'); new_stack = stack.pop(); assert(new_stack == stack_1); stack = new_stack; assert(!stack.is_empty()); assert(!stack.is_full()); assert(stack.top() == '\1'); new_stack = stack.push('\3'); assert(stack != new_stack); assert(new_stack != stack_1); assert(new_stack != stack_2); stack = new_stack; assert(!stack.is_empty()); assert(stack.is_full()); assert(stack.top() == '\3'); } static void test_state_queue() { constexpr unsigned N = 2; state::Queue queue; state::Queue new_queue; state::Queue queue_1, queue_2; assert(queue.is_empty()); assert(!queue.is_full()); queue.enqueue('\1'); new_queue = queue.enqueue('\1'); assert(queue != new_queue); queue = queue_1 = new_queue; assert(!queue.is_empty()); assert(!queue.is_full()); assert(queue.get_value() == '\1'); new_queue = queue.enqueue('\2'); assert(queue != new_queue); queue = queue_2 = new_queue; assert(queue_1 != queue_2); assert(!queue.is_empty()); assert(queue.is_full()); assert(queue.get_value() == '\1'); new_queue = queue.dequeue(); assert(new_queue != queue_1); queue = new_queue; assert(!queue.is_empty()); assert(!queue.is_full()); assert(queue.get_value() == '\2'); new_queue = queue.enqueue('\1'); assert(queue != new_queue); assert(new_queue != queue_2); queue = new_queue; assert(!queue.is_empty()); assert(queue.is_full()); assert(queue.get_value() == '\2'); new_queue = queue.dequeue(); assert(new_queue != queue_1); queue = new_queue; assert(!queue.is_empty()); assert(!queue.is_full()); assert(queue.get_value() == '\1'); new_queue = queue.enqueue('\3'); assert(queue != new_queue); assert(new_queue != queue_1); assert(new_queue != queue_2); queue = new_queue; assert(!queue.is_empty()); assert(queue.is_full()); assert(queue.get_value() == '\1'); } static void test_state_stack_op() { constexpr unsigned N = 1; bool ok; state::Stack stack, new_stack; OpPtr> try_push_1_op_ptr, try_push_2_op_ptr; OpPtr> try_pop_op_ptr; OpPtr> true_try_push_ret_op_ptr{ state::Stack::make_try_push_ret(true) }; OpPtr> false_try_push_ret_op_ptr{ state::Stack::make_try_push_ret(false) }; const Op>& true_try_push_ret_op = *true_try_push_ret_op_ptr; const Op>& false_try_push_ret_op = *false_try_push_ret_op_ptr; OpPtr> true_1_try_pop_ret_op_ptr{ state::Stack::make_try_pop_ret(true, '\1') }; OpPtr> true_2_try_pop_ret_op_ptr{ state::Stack::make_try_pop_ret(true, '\2') }; OpPtr> false_try_pop_ret_op_ptr{ state::Stack::make_try_pop_ret(false, '\0') }; const Op>& true_1_try_pop_ret_op = *true_1_try_pop_ret_op_ptr; const Op>& true_2_try_pop_ret_op = *true_2_try_pop_ret_op_ptr; const Op>& false_try_pop_ret_op = *false_try_pop_ret_op_ptr; try_pop_op_ptr = state::Stack::make_try_pop_call(); Op>& try_pop_op = *try_pop_op_ptr; std::tie(ok, new_stack) = try_pop_op.apply(stack, false_try_pop_ret_op); assert(stack == new_stack); assert(ok); std::tie(ok, new_stack) = try_pop_op.apply(stack, true_1_try_pop_ret_op); assert(stack == new_stack); assert(!ok); std::tie(ok, new_stack) = try_pop_op.apply(stack, true_2_try_pop_ret_op); assert(stack == new_stack); assert(!ok); try_push_2_op_ptr = state::Stack::make_try_push_call('\2'); Op>& try_push_2_op = *try_push_2_op_ptr; std::tie(ok, new_stack) = try_push_2_op.apply(stack, false_try_push_ret_op); assert(stack != new_stack); assert(!ok); std::tie(ok, new_stack) = try_push_2_op.apply(stack, true_try_push_ret_op); assert(stack != new_stack); assert(ok); stack = new_stack; try_push_1_op_ptr = state::Stack::make_try_push_call('\1'); Op>& try_push_1_op = *try_push_1_op_ptr; // stack is full std::tie(ok, new_stack) = try_push_1_op.apply(stack, false_try_push_ret_op); assert(stack == new_stack); assert(ok); std::tie(ok, new_stack) = try_push_1_op.apply(stack, true_try_push_ret_op); assert(stack == new_stack); assert(!ok); std::tie(ok, new_stack) = try_pop_op.apply(stack, false_try_pop_ret_op); assert(stack != new_stack); assert(!ok); std::tie(ok, new_stack) = try_pop_op.apply(stack, true_1_try_pop_ret_op); assert(stack != new_stack); assert(!ok); std::tie(ok, new_stack) = try_pop_op.apply(stack, true_2_try_pop_ret_op); assert(stack != new_stack); assert(ok); } static void test_state_queue_op() { constexpr unsigned N = 1; bool ok; state::Queue queue, new_queue; OpPtr> try_enqueue_1_op_ptr, try_enqueue_2_op_ptr; OpPtr> try_dequeue_op_ptr; OpPtr> true_try_enqueue_ret_op_ptr{ state::Queue::make_try_enqueue_ret(true) }; OpPtr> false_try_enqueue_ret_op_ptr{ state::Queue::make_try_enqueue_ret(false) }; const Op>& true_try_enqueue_ret_op = *true_try_enqueue_ret_op_ptr; const Op>& false_try_enqueue_ret_op = *false_try_enqueue_ret_op_ptr; OpPtr> true_1_try_dequeue_ret_op_ptr{ state::Queue::make_try_dequeue_ret(true, '\1') }; OpPtr> true_2_try_dequeue_ret_op_ptr{ state::Queue::make_try_dequeue_ret(true, '\2') }; OpPtr> false_try_dequeue_ret_op_ptr{ state::Queue::make_try_dequeue_ret(false, '\0') }; const Op>& true_1_try_dequeue_ret_op = *true_1_try_dequeue_ret_op_ptr; const Op>& true_2_try_dequeue_ret_op = *true_2_try_dequeue_ret_op_ptr; const Op>& false_try_dequeue_ret_op = *false_try_dequeue_ret_op_ptr; try_dequeue_op_ptr = state::Queue::make_try_dequeue_call(); Op>& try_dequeue_op = *try_dequeue_op_ptr; std::tie(ok, new_queue) = try_dequeue_op.apply(queue, false_try_dequeue_ret_op); assert(queue == new_queue); assert(ok); std::tie(ok, new_queue) = try_dequeue_op.apply(queue, true_1_try_dequeue_ret_op); assert(queue == new_queue); assert(!ok); std::tie(ok, new_queue) = try_dequeue_op.apply(queue, true_2_try_dequeue_ret_op); assert(queue == new_queue); assert(!ok); try_enqueue_2_op_ptr = state::Queue::make_try_enqueue_call('\2'); Op>& try_enqueue_2_op = *try_enqueue_2_op_ptr; std::tie(ok, new_queue) = try_enqueue_2_op.apply(queue, false_try_enqueue_ret_op); assert(queue != new_queue); assert(!ok); std::tie(ok, new_queue) = try_enqueue_2_op.apply(queue, true_try_enqueue_ret_op); assert(queue != new_queue); assert(ok); queue = new_queue; try_enqueue_1_op_ptr = state::Queue::make_try_enqueue_call('\1'); Op>& try_enqueue_1_op = *try_enqueue_1_op_ptr; // queue is full std::tie(ok, new_queue) = try_enqueue_1_op.apply(queue, false_try_enqueue_ret_op); assert(queue == new_queue); assert(ok); std::tie(ok, new_queue) = try_enqueue_1_op.apply(queue, true_try_enqueue_ret_op); assert(queue == new_queue); assert(!ok); std::tie(ok, new_queue) = try_dequeue_op.apply(queue, false_try_dequeue_ret_op); assert(queue != new_queue); assert(!ok); std::tie(ok, new_queue) = try_dequeue_op.apply(queue, true_1_try_dequeue_ret_op); assert(queue != new_queue); assert(!ok); std::tie(ok, new_queue) = try_dequeue_op.apply(queue, true_2_try_dequeue_ret_op); assert(queue != new_queue); assert(ok); } /// The empty log is trivially linearizable. static void test_linearizability_empty_log() { std::size_t number_of_entries{ 0U }; LogInfo log_info; LinearizabilityTester t{ log_info }; assert(log_info.is_empty()); assert(t.check()); } /// a few sanity checks on the raw entry data structure static void test_raw_single_contains_is_linearizable() { Entry contains_call, contains_ret; contains_ret.set_op(state::Set::make_ret(false)); contains_ret.prev = &contains_call; contains_call.set_op(state::Set::make_contains_call('\1')); contains_call.next = &contains_ret; contains_call.set_match(&contains_ret); std::size_t number_of_entries{ 2U }; LogInfo log_info{ &contains_call, number_of_entries }; LinearizabilityTester t{ log_info }; assert(t.check()); } static void test_raw_single_contains_is_not_linearizable() { Entry contains_call, contains_ret; contains_ret.set_op(state::Set::make_ret(true)); contains_ret.prev = &contains_call; contains_call.set_op(state::Set::make_contains_call('\1')); contains_call.next = &contains_ret; contains_call.set_match(&contains_ret); std::size_t number_of_entries{ 2U }; LogInfo log_info{ &contains_call, number_of_entries }; LinearizabilityTester t{ log_info }; assert(!t.check()); } static void test_single_contains(bool ret) { Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; contains_call_entry_ptr = log.add_call(state::Set::make_contains_call('\1')); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(ret)); assert(log.log_head_ptr() == contains_call_entry_ptr); assert(log.number_of_entries() == 2U); assert(log.log_head_ptr() == contains_call_entry_ptr); assert(contains_call_entry_ptr->prev == nullptr); assert(contains_call_entry_ptr->next == contains_ret_entry_ptr); assert(contains_call_entry_ptr->match() == contains_ret_entry_ptr); assert(contains_ret_entry_ptr->match() == contains_call_entry_ptr); assert(contains_ret_entry_ptr->prev == contains_call_entry_ptr); assert(contains_ret_entry_ptr->next == nullptr); LinearizabilityTester t{ log.info() }; assert(t.check() == (!ret)); if (ret) { // If log cannot be linearized, then all pointers // (except the first one) are still the same. assert(log.log_head_ptr() == contains_call_entry_ptr); assert(contains_call_entry_ptr->prev != nullptr); assert(contains_call_entry_ptr->next == contains_ret_entry_ptr); assert(contains_call_entry_ptr->match() == contains_ret_entry_ptr); assert(contains_ret_entry_ptr->match() == contains_call_entry_ptr); assert(contains_ret_entry_ptr->prev == contains_call_entry_ptr); assert(contains_ret_entry_ptr->next == nullptr); } } static void test_log_copy() { constexpr bool ret = true; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; contains_call_entry_ptr = log.add_call(state::Set::make_contains_call('\1')); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(ret)); assert(log.log_head_ptr() == contains_call_entry_ptr); assert(log.number_of_entries() == 2U); assert(log.log_head_ptr() == contains_call_entry_ptr); assert(contains_call_entry_ptr->prev == nullptr); assert(contains_call_entry_ptr->next == contains_ret_entry_ptr); assert(contains_call_entry_ptr->match() == contains_ret_entry_ptr); assert(contains_ret_entry_ptr->match() == contains_call_entry_ptr); assert(contains_ret_entry_ptr->prev == contains_call_entry_ptr); assert(contains_ret_entry_ptr->next == nullptr); Log log_copy{ log.info() }; assert(log_copy.log_head_ptr() != contains_call_entry_ptr); assert(log_copy.log_head_ptr() != contains_call_entry_ptr); assert(log_copy.log_head_ptr()->entry_id() == 0U); assert(&log_copy.log_head_ptr()->op() == &contains_call_entry_ptr->op()); assert(log_copy.log_head_ptr() == log_copy.log_head_ptr()->match()->match()); assert(log_copy.log_head_ptr()->prev == nullptr); assert(log_copy.number_of_entries() == 2U); } // contains(x) : contains_ret // |---------------------------| // // insert(x) : insert_ret // |---------------------------| static void test_000(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned contains_entry_id{ 0U }; constexpr unsigned insert_entry_id{ 1U }; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_call_entry_ptr, insert_ret_entry_ptr; contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); insert_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); insert_ret_entry_ptr = log.add_ret(insert_call_entry_ptr, state::Set::make_ret(insert_ret)); assert(insert_call_entry_ptr->entry_id() == insert_entry_id); assert(insert_ret_entry_ptr->entry_id() == insert_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == insert_ret); } // contains(x) : contains_ret // |----------------------------| // // insert(x) : insert_ret // |-------------------------| static void test_001(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned insert_entry_id{ 0U }; constexpr unsigned contains_entry_id{ 1U }; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_call_entry_ptr, insert_ret_entry_ptr; insert_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); insert_ret_entry_ptr = log.add_ret(insert_call_entry_ptr, state::Set::make_ret(insert_ret)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); assert(insert_call_entry_ptr->entry_id() == insert_entry_id); assert(insert_ret_entry_ptr->entry_id() == insert_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == insert_ret); } // contains(x) : contains_ret // |----------------------------| // // insert(x) : insert_ret // |----------------------------------| static void test_002(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned insert_entry_id{ 0U }; constexpr unsigned contains_entry_id{ 1U }; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_call_entry_ptr, insert_ret_entry_ptr; insert_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); insert_ret_entry_ptr = log.add_ret(insert_call_entry_ptr, state::Set::make_ret(insert_ret)); assert(insert_call_entry_ptr->entry_id() == insert_entry_id); assert(insert_ret_entry_ptr->entry_id() == insert_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == insert_ret); } // contains(x) : contains_ret // |----------------------------------| // // insert(x) : insert_ret // |---------------------------| static void test_003(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned contains_entry_id{ 0U }; constexpr unsigned insert_entry_id{ 1U }; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_call_entry_ptr, insert_ret_entry_ptr; contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); insert_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_ret_entry_ptr = log.add_ret(insert_call_entry_ptr, state::Set::make_ret(insert_ret)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); assert(insert_call_entry_ptr->entry_id() == insert_entry_id); assert(insert_ret_entry_ptr->entry_id() == insert_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == insert_ret); } // insert(x) : insert_ret contains(x) : contains_ret // |------------------------| |---------------------------| static void test_004(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned insert_entry_id{ 0U }; constexpr unsigned contains_entry_id{ 1U }; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_call_entry_ptr, insert_ret_entry_ptr; insert_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_ret_entry_ptr = log.add_ret(insert_call_entry_ptr, state::Set::make_ret(insert_ret)); contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); assert(insert_call_entry_ptr->entry_id() == insert_entry_id); assert(insert_ret_entry_ptr->entry_id() == insert_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == (insert_ret && contains_ret)); } // contains(x) : contains_ret insert(x) : insert_ret // |---------------------------| |------------------------| static void test_005(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned contains_entry_id{ 0U }; constexpr unsigned insert_entry_id{ 1U }; Log log{ 4U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_call_entry_ptr, insert_ret_entry_ptr; contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); insert_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_ret_entry_ptr = log.add_ret(insert_call_entry_ptr, state::Set::make_ret(insert_ret)); assert(insert_call_entry_ptr->entry_id() == insert_entry_id); assert(insert_ret_entry_ptr->entry_id() == insert_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == (insert_ret && !contains_ret)); } // insert(x) : insert_ret_0 // |--------------------------| // // insert(x) : insert_ret_1 // |--------------------------| static void test_006(bool insert_ret_0, bool insert_ret_1) { constexpr char x = '\1'; constexpr unsigned insert_0_entry_id{ 0U }; constexpr unsigned insert_1_entry_id{ 1U }; EntryPtr insert_call_0_entry_ptr, insert_ret_0_entry_ptr; EntryPtr insert_call_1_entry_ptr, insert_ret_1_entry_ptr; Log log{ 4U }; insert_call_0_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_call_1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_ret_0_entry_ptr = log.add_ret(insert_call_0_entry_ptr, state::Set::make_ret(insert_ret_0)); insert_ret_1_entry_ptr = log.add_ret(insert_call_1_entry_ptr, state::Set::make_ret(insert_ret_1)); assert(insert_call_0_entry_ptr->entry_id() == insert_0_entry_id); assert(insert_ret_0_entry_ptr->entry_id() == insert_0_entry_id); assert(insert_call_1_entry_ptr->entry_id() == insert_1_entry_id); assert(insert_ret_1_entry_ptr->entry_id() == insert_1_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == (!(insert_ret_0 == insert_ret_1))); } // insert(x) : insert_ret_0 insert(x) : insert_ret_1 // |--------------------------| |--------------------------| static void test_007(bool insert_ret_0, bool insert_ret_1) { constexpr char x = '\1'; constexpr unsigned insert_0_entry_id{ 0U }; constexpr unsigned insert_1_entry_id{ 1U }; EntryPtr insert_call_0_entry_ptr, insert_ret_0_entry_ptr; EntryPtr insert_call_1_entry_ptr, insert_ret_1_entry_ptr; Log log{ 4U }; insert_call_0_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_ret_0_entry_ptr = log.add_ret(insert_call_0_entry_ptr, state::Set::make_ret(insert_ret_0)); insert_call_1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_ret_1_entry_ptr = log.add_ret(insert_call_1_entry_ptr, state::Set::make_ret(insert_ret_1)); assert(insert_call_0_entry_ptr->entry_id() == insert_0_entry_id); assert(insert_ret_0_entry_ptr->entry_id() == insert_0_entry_id); assert(insert_call_1_entry_ptr->entry_id() == insert_1_entry_id); assert(insert_ret_1_entry_ptr->entry_id() == insert_1_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check() == (insert_ret_0 && !insert_ret_1)); } // insert(x) : insert_ret // |------------------------------------------| // // insert(x) : insert_ret // |-------------------------------------| // // contains(x) : contains_ret // |----------------------------| // static void test_008(bool insert_ret, bool contains_ret) { constexpr char x = '\1'; constexpr unsigned insert_0_entry_id{ 0U }; constexpr unsigned insert_1_entry_id{ 1U }; constexpr unsigned contains_entry_id{ 2U }; Log log{ 8U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; EntryPtr insert_0_call_entry_ptr, insert_0_ret_entry_ptr; EntryPtr insert_1_call_entry_ptr, insert_1_ret_entry_ptr; insert_0_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_1_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(contains_ret)); insert_1_ret_entry_ptr = log.add_ret(insert_1_call_entry_ptr, state::Set::make_ret(insert_ret)); insert_0_ret_entry_ptr = log.add_ret(insert_0_call_entry_ptr, state::Set::make_ret(insert_ret)); assert(insert_0_call_entry_ptr->entry_id() == insert_0_entry_id); assert(insert_0_ret_entry_ptr->entry_id() == insert_0_entry_id); assert(insert_1_call_entry_ptr->entry_id() == insert_1_entry_id); assert(insert_1_ret_entry_ptr->entry_id() == insert_1_entry_id); assert(contains_call_entry_ptr->entry_id() == contains_entry_id); assert(contains_ret_entry_ptr->entry_id() == contains_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // !linearizable: // // Let x && y be distinct values. // // contains(x) : false // |---------------------| // // contains(y) : false // |---------------------| // // insert(x) : false // |---------------------| static void test_009() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned contains_x_entry_id{ 0U }; constexpr unsigned contains_y_entry_id{ 1U }; constexpr unsigned insert_x_entry_id{ 2U }; Log log{ 6U }; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(false)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(false)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(false)); assert(contains_x_call_entry_ptr->entry_id() == contains_x_entry_id); assert(contains_x_ret_entry_ptr->entry_id() == contains_x_entry_id); assert(contains_y_call_entry_ptr->entry_id() == contains_y_entry_id); assert(contains_y_ret_entry_ptr->entry_id() == contains_y_entry_id); assert(insert_x_call_entry_ptr->entry_id() == insert_x_entry_id); assert(insert_x_ret_entry_ptr->entry_id() == insert_x_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // !linearizable: // // Let x && y be distinct values. // // contains(x) : false // |---------------------| // // insert(x) : false // |---------------------| // // contains(y) : false // |---------------------| static void test_010() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned contains_x_entry_id{ 0U }; constexpr unsigned insert_x_entry_id{ 1U }; constexpr unsigned contains_y_entry_id{ 2U }; Log log{ 6U }; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(false)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(false)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(false)); assert(contains_x_call_entry_ptr->entry_id() == contains_x_entry_id); assert(contains_x_ret_entry_ptr->entry_id() == contains_x_entry_id); assert(insert_x_call_entry_ptr->entry_id() == insert_x_entry_id); assert(insert_x_ret_entry_ptr->entry_id() == insert_x_entry_id); assert(contains_y_call_entry_ptr->entry_id() == contains_y_entry_id); assert(contains_y_ret_entry_ptr->entry_id() == contains_y_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // Linearizable: // // Let x && y be distinct values. // // insert(x) : true // |------------------| // // contains(y) : false // |---------------------| // // contains(x) : false // |---------------------| static void test_011() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned insert_x_entry_id{ 0U }; constexpr unsigned contains_y_entry_id{ 1U }; constexpr unsigned contains_x_entry_id{ 2U }; Log log{ 6U }; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(true)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(false)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(false)); assert(insert_x_call_entry_ptr->entry_id() == insert_x_entry_id); assert(insert_x_ret_entry_ptr->entry_id() == insert_x_entry_id); assert(contains_y_call_entry_ptr->entry_id() == contains_y_entry_id); assert(contains_y_ret_entry_ptr->entry_id() == contains_y_entry_id); assert(contains_x_call_entry_ptr->entry_id() == contains_x_entry_id); assert(contains_x_ret_entry_ptr->entry_id() == contains_x_entry_id); LinearizabilityTester t{ log.info() }; assert(t.check()); } // Linearizable: // // Let x && y be distinct values. // // erase(x) : false insert(y) : true // |------------------| |------------------| // // contains(x) : true // |------------------------------------------------| // // contains(y) : false insert(x) : true // |---------------------| |------------------| static void test_012() { constexpr char x = '\1'; constexpr char y = '\2'; Log log{ 10U }; EntryPtr erase_x_call_entry_ptr, erase_x_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr insert_y_call_entry_ptr, insert_y_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; erase_x_call_entry_ptr = log.add_call(state::Set::make_erase_call(x)); erase_x_ret_entry_ptr = log.add_ret(erase_x_call_entry_ptr, state::Set::make_ret(false)); insert_y_call_entry_ptr = log.add_call(state::Set::make_insert_call(y)); contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); insert_y_ret_entry_ptr = log.add_ret(insert_y_call_entry_ptr, state::Set::make_ret(true)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(false)); insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(true)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(true)); LinearizabilityTester t{ log.info() }; assert(t.check()); } // entry id: X0, call: contains(x) // entry id: X1, call: insert(x) // entry id: X0, return: ret: 0 // entry id: X2, call: contains(x) // entry id: X2, return: ret: 0 // entry id: X3, call: insert(x) // entry id: X3, return: ret: 1 // entry id: X4, call: contains(x) // entry id: X4, return: ret: 1 // entry id: X1, return: ret: 0 // entry id: X5, call: contains(x) // entry id: X5, return: ret: 1 static void test_013() { constexpr char x = '\1'; Log log{ 12U }; EntryPtr call_x0_entry_ptr, ret_x0_entry_ptr; EntryPtr call_x1_entry_ptr, ret_x1_entry_ptr; EntryPtr call_x2_entry_ptr, ret_x2_entry_ptr; EntryPtr call_x3_entry_ptr, ret_x3_entry_ptr; EntryPtr call_x4_entry_ptr, ret_x4_entry_ptr; EntryPtr call_x5_entry_ptr, ret_x5_entry_ptr; call_x0_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_x1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x0_entry_ptr = log.add_ret(call_x0_entry_ptr, state::Set::make_ret(false)); call_x2_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x2_entry_ptr = log.add_ret(call_x2_entry_ptr, state::Set::make_ret(false)); call_x3_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x3_entry_ptr = log.add_ret(call_x3_entry_ptr, state::Set::make_ret(true)); call_x4_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x4_entry_ptr = log.add_ret(call_x4_entry_ptr, state::Set::make_ret(true)); ret_x1_entry_ptr = log.add_ret(call_x1_entry_ptr, state::Set::make_ret(false)); call_x5_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x5_entry_ptr = log.add_ret(call_x5_entry_ptr, state::Set::make_ret(true)); LinearizabilityTester t{ log.info() }; assert(t.check()); } // Let x && y be distinct. // // entry id: X0, call: contains(x) // entry id: X1, call: insert(x) // entry id: X0, return: ret: 0 // entry id: Y0, call: contains(y) <- !linearizable // entry id: Y0, return: ret: 1 // entry id: X2, call: contains(x) // entry id: X2, return: ret: 0 // entry id: X3, call: insert(x) // entry id: X3, return: ret: 1 // entry id: X4, call: contains(x) // entry id: X4, return: ret: 1 // entry id: X1, return: ret: 0 // entry id: X5, call: contains(x) // entry id: X5, return: ret: 1 static void test_014() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned not_linearizable_entry_id = 2U; Log log{ 14U }; EntryPtr call_x0_entry_ptr, ret_x0_entry_ptr; EntryPtr call_x1_entry_ptr, ret_x1_entry_ptr; EntryPtr call_x2_entry_ptr, ret_x2_entry_ptr; EntryPtr call_x3_entry_ptr, ret_x3_entry_ptr; EntryPtr call_x4_entry_ptr, ret_x4_entry_ptr; EntryPtr call_x5_entry_ptr, ret_x5_entry_ptr; EntryPtr call_y0_entry_ptr, ret_y0_entry_ptr; call_x0_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_x1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x0_entry_ptr = log.add_ret(call_x0_entry_ptr, state::Set::make_ret(false)); call_y0_entry_ptr = log.add_call(state::Set::make_contains_call(y)); ret_y0_entry_ptr = log.add_ret(call_y0_entry_ptr, state::Set::make_ret(true)); call_x2_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x2_entry_ptr = log.add_ret(call_x2_entry_ptr, state::Set::make_ret(false)); call_x3_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x3_entry_ptr = log.add_ret(call_x3_entry_ptr, state::Set::make_ret(true)); call_x4_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x4_entry_ptr = log.add_ret(call_x4_entry_ptr, state::Set::make_ret(true)); ret_x1_entry_ptr = log.add_ret(call_x1_entry_ptr, state::Set::make_ret(false)); call_x5_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x5_entry_ptr = log.add_ret(call_x5_entry_ptr, state::Set::make_ret(true)); assert(call_y0_entry_ptr->entry_id() == not_linearizable_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // !linearizable: // // Let x && y be distinct values. // // contains(x) : false contains(y) : true // |---------------------| |--------------------| // // insert(x) : true // |----------------------------| static void test_015() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned contains_x_entry_id{ 0U }; constexpr unsigned insert_x_entry_id{ 1U }; constexpr unsigned contains_y_entry_id{ 2U }; Log log{ 6U }; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(false)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(true)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(true)); assert(contains_x_call_entry_ptr->entry_id() == contains_x_entry_id); assert(contains_x_ret_entry_ptr->entry_id() == contains_x_entry_id); assert(insert_x_call_entry_ptr->entry_id() == insert_x_entry_id); assert(insert_x_ret_entry_ptr->entry_id() == insert_x_entry_id); assert(contains_y_call_entry_ptr->entry_id() == contains_y_entry_id); assert(contains_y_ret_entry_ptr->entry_id() == contains_y_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // !linearizable: // // Let x && y be distinct values. // // contains(x) : false contains(y) : true contains(x) : false // |---------------------| |--------------------| |---------------------| // // insert(x) : true // |------------------------------| static void test_016() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned not_linearizable_entry_id = 2U; Log log{ 8U }; EntryPtr call_x0_entry_ptr, ret_x0_entry_ptr; EntryPtr call_x1_entry_ptr, ret_x1_entry_ptr; EntryPtr call_x2_entry_ptr, ret_x2_entry_ptr; EntryPtr call_y0_entry_ptr, ret_y0_entry_ptr; call_x0_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_x1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x0_entry_ptr = log.add_ret(call_x0_entry_ptr, state::Set::make_ret(false)); call_y0_entry_ptr = log.add_call(state::Set::make_contains_call(y)); ret_y0_entry_ptr = log.add_ret(call_y0_entry_ptr, state::Set::make_ret(true)); call_x2_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x1_entry_ptr = log.add_ret(call_x1_entry_ptr, state::Set::make_ret(true)); ret_x2_entry_ptr = log.add_ret(call_x2_entry_ptr, state::Set::make_ret(false)); assert(call_y0_entry_ptr->entry_id() == not_linearizable_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // !linearizable: // // Let x && y be distinct values. // // contains(x) : false contains(y) : true contains(x) : false // |---------------------| |--------------------| |---------------------| // // insert(x) : true // |-----------------------------------------------------| static void test_017() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned not_linearizable_entry_id = 2U; Log log{ 8U }; EntryPtr call_x0_entry_ptr, ret_x0_entry_ptr; EntryPtr call_x1_entry_ptr, ret_x1_entry_ptr; EntryPtr call_x2_entry_ptr, ret_x2_entry_ptr; EntryPtr call_y0_entry_ptr, ret_y0_entry_ptr; call_x0_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_x1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x0_entry_ptr = log.add_ret(call_x0_entry_ptr, state::Set::make_ret(false)); call_y0_entry_ptr = log.add_call(state::Set::make_contains_call(y)); ret_y0_entry_ptr = log.add_ret(call_y0_entry_ptr, state::Set::make_ret(true)); call_x2_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_x2_entry_ptr = log.add_ret(call_x2_entry_ptr, state::Set::make_ret(false)); ret_x1_entry_ptr = log.add_ret(call_x1_entry_ptr, state::Set::make_ret(true)); assert(call_y0_entry_ptr->entry_id() == not_linearizable_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // !linearizable: // // Let x && y be distinct values. // // contains(y) : true insert(x) : true // |--------------------| |------------------| // // insert(x) : false // |------------------------------------------------| static void test_018() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr unsigned not_linearizable_entry_id = 1U; Log log{ 8U }; EntryPtr call_x0_entry_ptr, ret_x0_entry_ptr; EntryPtr call_x1_entry_ptr, ret_x1_entry_ptr; EntryPtr call_y0_entry_ptr, ret_y0_entry_ptr; call_x0_entry_ptr = log.add_call(state::Set::make_insert_call(x)); call_y0_entry_ptr = log.add_call(state::Set::make_contains_call(y)); ret_y0_entry_ptr = log.add_ret(call_y0_entry_ptr, state::Set::make_ret(true)); call_x1_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_x1_entry_ptr = log.add_ret(call_x1_entry_ptr, state::Set::make_ret(true)); ret_x0_entry_ptr = log.add_ret(call_x1_entry_ptr, state::Set::make_ret(false)); assert(call_y0_entry_ptr->entry_id() == not_linearizable_entry_id); LinearizabilityTester t{ log.info() }; assert(!t.check()); } // Linearizable: // // insert(x) : insert_ret // |------------------------| // // contains(x) : contains_ret // |-----------------------------| // // empty() : empty_ret // |------------------------| static void test_019(bool insert_ret, bool contains_ret, bool empty_ret) { constexpr char x = '\1'; Log log{ 8U }; EntryPtr call_insert_entry_ptr, ret_insert_entry_ptr; EntryPtr call_contains_entry_ptr, ret_contains_entry_ptr; EntryPtr call_empty_entry_ptr, ret_empty_entry_ptr; call_insert_entry_ptr = log.add_call(state::Set::make_insert_call(x)); call_contains_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_empty_entry_ptr = log.add_call(state::Set::make_empty_call()); ret_insert_entry_ptr = log.add_ret(call_insert_entry_ptr, state::Set::make_ret(insert_ret)); ret_empty_entry_ptr = log.add_ret(call_empty_entry_ptr, state::Set::make_ret(empty_ret)); ret_contains_entry_ptr = log.add_ret(call_contains_entry_ptr, state::Set::make_ret(contains_ret)); LinearizabilityTester t{ log.info() }; assert(t.check() == insert_ret); } // insert(x) : insert_ret // |------------------------| // // contains(x) : contains_ret contains(x) : contains_ret // |----------------------------| |----------------------------| // // empty() : empty_ret // |----------------------| static void test_020(bool insert_ret, bool contains_ret, bool empty_ret) { constexpr char x = '\1'; Log log{ 8U }; EntryPtr call_contains_0_entry_ptr, ret_contains_0_entry_ptr; EntryPtr call_contains_1_entry_ptr, ret_contains_1_entry_ptr; EntryPtr call_insert_entry_ptr, ret_insert_entry_ptr; EntryPtr call_empty_entry_ptr, ret_empty_entry_ptr; call_contains_0_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_contains_0_entry_ptr = log.add_ret(call_contains_0_entry_ptr, state::Set::make_ret(contains_ret)); call_contains_1_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_empty_entry_ptr = log.add_call(state::Set::make_empty_call()); call_insert_entry_ptr = log.add_call(state::Set::make_insert_call(x)); ret_contains_1_entry_ptr = log.add_ret(call_contains_1_entry_ptr, state::Set::make_ret(contains_ret)); ret_empty_entry_ptr = log.add_ret(call_empty_entry_ptr, state::Set::make_ret(empty_ret)); ret_insert_entry_ptr = log.add_ret(call_insert_entry_ptr, state::Set::make_ret(insert_ret)); LinearizabilityTester t{ log.info() }; assert(t.check() == (insert_ret && !contains_ret)); } // Linearizable: // // Let x && y be distinct values. // // contains(x) : false // |---------------------| // // insert(y) : true // |-----------------------------------------------------------| // // contains(x) : false empty() : true // |---------------------| |----------------| static void test_021() { constexpr char x = '\1'; constexpr char y = '\2'; Log log{ 8U }; EntryPtr call_contains_0_entry_ptr, ret_contains_0_entry_ptr; EntryPtr call_contains_1_entry_ptr, ret_contains_1_entry_ptr; EntryPtr call_insert_entry_ptr, ret_insert_entry_ptr; EntryPtr call_empty_entry_ptr, ret_empty_entry_ptr; call_contains_0_entry_ptr = log.add_call(state::Set::make_contains_call(x)); call_insert_entry_ptr = log.add_call(state::Set::make_insert_call(y)); ret_contains_0_entry_ptr = log.add_ret(call_contains_0_entry_ptr, state::Set::make_ret(false)); call_contains_1_entry_ptr = log.add_call(state::Set::make_contains_call(x)); ret_contains_1_entry_ptr = log.add_ret(call_contains_1_entry_ptr, state::Set::make_ret(false)); call_empty_entry_ptr = log.add_call(state::Set::make_empty_call()); ret_empty_entry_ptr = log.add_ret(call_empty_entry_ptr, state::Set::make_ret(true)); ret_insert_entry_ptr = log.add_ret(call_insert_entry_ptr, state::Set::make_ret(1)); LinearizabilityTester t{ log.info() }; assert(t.check()); } // Linearizable: // // push(x) : true // |------------------------| // // push(y) : true // |--------------------| // // pop() : (true, x) // |------------------| static void test_stack_history_000() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr std::size_t N = 5; Log> log{ 6U }; EntryPtr> try_push_x_call_entry_ptr, try_push_x_ret_entry_ptr; EntryPtr> try_push_y_call_entry_ptr, try_push_y_ret_entry_ptr; EntryPtr> try_pop_x_call_entry_ptr, try_pop_x_ret_entry_ptr; try_push_x_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(x)); try_push_y_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(y)); try_pop_x_call_entry_ptr = log.add_call(state::Stack::make_try_pop_call()); try_push_x_ret_entry_ptr = log.add_ret(try_push_x_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_push_y_ret_entry_ptr = log.add_ret(try_push_y_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_pop_x_ret_entry_ptr = log.add_ret(try_pop_x_call_entry_ptr, state::Stack::make_try_pop_ret(true, x)); assert(!try_push_x_call_entry_ptr->is_partitionable()); assert(!try_push_y_call_entry_ptr->is_partitionable()); assert(!try_pop_x_call_entry_ptr->is_partitionable()); assert(!try_push_x_ret_entry_ptr->is_partitionable()); assert(!try_push_y_ret_entry_ptr->is_partitionable()); assert(!try_pop_x_ret_entry_ptr->is_partitionable()); LinearizabilityTester> t{ log.info() }; assert(t.check()); } // push(x):true; push(y):true; pop():x static void test_stack_history_001() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr std::size_t N = 5; Log> log{ 6U }; EntryPtr> try_push_x_call_entry_ptr, try_push_x_ret_entry_ptr; EntryPtr> try_push_y_call_entry_ptr, try_push_y_ret_entry_ptr; EntryPtr> try_pop_x_call_entry_ptr, try_pop_x_ret_entry_ptr; try_push_x_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(x)); try_push_x_ret_entry_ptr = log.add_ret(try_push_x_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_push_y_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(y)); try_push_y_ret_entry_ptr = log.add_ret(try_push_y_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_pop_x_call_entry_ptr = log.add_call(state::Stack::make_try_pop_call()); try_pop_x_ret_entry_ptr = log.add_ret(try_pop_x_call_entry_ptr, state::Stack::make_try_pop_ret(true, x)); assert(!try_push_x_call_entry_ptr->is_partitionable()); assert(!try_push_y_call_entry_ptr->is_partitionable()); assert(!try_pop_x_call_entry_ptr->is_partitionable()); assert(!try_push_x_ret_entry_ptr->is_partitionable()); assert(!try_push_y_ret_entry_ptr->is_partitionable()); assert(!try_pop_x_ret_entry_ptr->is_partitionable()); LinearizabilityTester> t{ log.info() }; assert(!t.check()); } // entry id: 0, thread id: 0x2, call: try_push(x) // entry id: 0, thread id: 0x2, return: ret: 1 // entry id: 1, thread id: 0x3, call: try_push(y) // entry id: 2, thread id: 0x4, call: try_pop() // entry id: 2, thread id: 0x4, return: ret: [ok: 1, value: x] // entry id: 1, thread id: 0x3, return: ret: 1 static void test_stack_history_002() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr std::size_t N = 5; Log> log{ 8U }; EntryPtr> try_push_x_call_entry_ptr, try_push_x_ret_entry_ptr; EntryPtr> try_push_y_call_entry_ptr, try_push_y_ret_entry_ptr; EntryPtr> try_pop_x_call_entry_ptr, try_pop_x_ret_entry_ptr; try_push_x_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(x)); try_push_x_ret_entry_ptr = log.add_ret(try_push_x_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_push_y_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(y)); try_pop_x_call_entry_ptr = log.add_call(state::Stack::make_try_pop_call()); try_pop_x_ret_entry_ptr = log.add_ret(try_pop_x_call_entry_ptr, state::Stack::make_try_pop_ret(true, x)); try_push_y_ret_entry_ptr = log.add_ret(try_push_y_call_entry_ptr, state::Stack::make_try_push_ret(true)); assert(!try_push_x_call_entry_ptr->is_partitionable()); assert(!try_push_y_call_entry_ptr->is_partitionable()); assert(!try_pop_x_call_entry_ptr->is_partitionable()); assert(!try_push_x_ret_entry_ptr->is_partitionable()); assert(!try_push_y_ret_entry_ptr->is_partitionable()); assert(!try_pop_x_ret_entry_ptr->is_partitionable()); LinearizabilityTester> t{ log.info() }; assert(t.check()); } // Linearizable: // // push(x) : true pop() : (true, y) // |----------------| |------------------| // // push(y) : true push(z) : true // |----------------| |---------------------------------| // // pop() : (true, x) pop() : (true, z) // |-------------------| |-------------------| static void test_stack_history_003() { constexpr char x = '\1'; constexpr char y = '\2'; constexpr char z = '\3'; constexpr std::size_t N = 5; Log> log{ 12U }; EntryPtr> try_push_x_call_entry_ptr, try_push_x_ret_entry_ptr; EntryPtr> try_push_y_call_entry_ptr, try_push_y_ret_entry_ptr; EntryPtr> try_push_z_call_entry_ptr, try_push_z_ret_entry_ptr; EntryPtr> try_pop_x_call_entry_ptr, try_pop_x_ret_entry_ptr; EntryPtr> try_pop_y_call_entry_ptr, try_pop_y_ret_entry_ptr; EntryPtr> try_pop_z_call_entry_ptr, try_pop_z_ret_entry_ptr; try_push_x_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(x)); try_push_y_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(y)); try_push_x_ret_entry_ptr = log.add_ret(try_push_x_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_push_y_ret_entry_ptr = log.add_ret(try_push_y_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_pop_y_call_entry_ptr = log.add_call(state::Stack::make_try_pop_call()); try_push_z_call_entry_ptr = log.add_call(state::Stack::make_try_push_call(z)); try_pop_y_ret_entry_ptr = log.add_ret(try_pop_y_call_entry_ptr, state::Stack::make_try_pop_ret(true, y)); try_pop_x_call_entry_ptr = log.add_call(state::Stack::make_try_pop_call()); try_pop_x_ret_entry_ptr = log.add_ret(try_pop_x_call_entry_ptr, state::Stack::make_try_pop_ret(true, x)); try_pop_z_call_entry_ptr = log.add_call(state::Stack::make_try_pop_call()); try_push_z_ret_entry_ptr = log.add_ret(try_push_z_call_entry_ptr, state::Stack::make_try_push_ret(true)); try_pop_z_ret_entry_ptr = log.add_ret(try_pop_z_call_entry_ptr, state::Stack::make_try_pop_ret(true, z)); LinearizabilityTester> t{ log.info() }; assert(t.check()); } // Let x = '\0' && y = '\1'. // // erase(x) : false insert(y) : true // |------------------| |------------------| // // contains(x) : true // |------------------------------------------------| // // contains(y) : false insert(x) : true // |---------------------| |------------------| static void test_slice_000() { constexpr char x = '\0'; constexpr char y = '\1'; Log log{ 10U }; EntryPtr erase_x_call_entry_ptr, erase_x_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr insert_y_call_entry_ptr, insert_y_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; erase_x_call_entry_ptr = log.add_call(state::Set::make_erase_call(x)); erase_x_ret_entry_ptr = log.add_ret(erase_x_call_entry_ptr, state::Set::make_ret(false)); insert_y_call_entry_ptr = log.add_call(state::Set::make_insert_call(y)); contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); insert_y_ret_entry_ptr = log.add_ret(insert_y_call_entry_ptr, state::Set::make_ret(true)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(false)); insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(true)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(true)); Slicer slicer{ log.info(), 2U }; assert(slicer.sublog_info(x).log_head_ptr() == erase_x_call_entry_ptr); assert(slicer.sublog_info(y).log_head_ptr() == insert_y_call_entry_ptr); assert(slicer.sublog_info(x).number_of_entries() == 6U); assert(slicer.sublog_info(y).number_of_entries() == 4U); LinearizabilityTester tester_0{ slicer.sublog_info(x) }; assert(tester_0.check()); LinearizabilityTester tester_1{ slicer.sublog_info(y) }; assert(tester_1.check()); } // Let x = '\0' && y = '\1'. // // contains(x) : false // |---------------------| // // contains(y) : false // |---------------------| // // insert(x) : false // |---------------------| static void test_slice_001() { constexpr char x = '\0'; constexpr char y = '\1'; Log log{ 6U }; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr contains_y_call_entry_ptr, contains_y_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; contains_x_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_y_call_entry_ptr = log.add_call(state::Set::make_contains_call(y)); insert_x_call_entry_ptr = log.add_call(state::Set::make_insert_call(x)); contains_x_ret_entry_ptr = log.add_ret(contains_x_call_entry_ptr, state::Set::make_ret(false)); contains_y_ret_entry_ptr = log.add_ret(contains_y_call_entry_ptr, state::Set::make_ret(false)); insert_x_ret_entry_ptr = log.add_ret(insert_x_call_entry_ptr, state::Set::make_ret(false)); Slicer slicer{ log.info(), 2U }; assert(slicer.sublog_info(x).log_head_ptr() == contains_x_call_entry_ptr); assert(slicer.sublog_info(y).log_head_ptr() == contains_y_call_entry_ptr); assert(slicer.sublog_info(x).number_of_entries() == 4U); assert(slicer.sublog_info(y).number_of_entries() == 2U); LinearizabilityTester tester_0{ slicer.sublog_info(x) }; assert(!tester_0.check()); LinearizabilityTester tester_1{ slicer.sublog_info(y) }; assert(tester_1.check()); } static void debug() { constexpr char x = '\1'; Log log{ 2U }; EntryPtr contains_call_entry_ptr, contains_ret_entry_ptr; contains_call_entry_ptr = log.add_call(state::Set::make_contains_call(x)); contains_ret_entry_ptr = log.add_ret(contains_call_entry_ptr, state::Set::make_ret(true)); LinearizabilityTester t{ log.info() }; Result result; t.check(result); assert(!result.is_linearizable()); std::stringstream os; result.debug(os); assert(os.str() == "Linearizable: No\n" "entry id: 0, thread id: 0, call: contains(1)\n" "^ previous entries cannot be linearized\n" "entry id: 0, thread id: 0, return: ret: 1\n" "^ previous entries cannot be linearized\n"); } static void concurrent_log() { constexpr unsigned number_of_partitions = 1U; constexpr char x = '\0'; ConcurrentLog log{ 6U }; EntryPtr contains_x_call_entry_ptr, contains_x_ret_entry_ptr; EntryPtr insert_x_call_entry_ptr, insert_x_ret_entry_ptr; contains_x_call_entry_ptr = log.push_back(state::Set::make_contains_call(x)); insert_x_call_entry_ptr = log.push_back(state::Set::make_insert_call(x)); contains_x_ret_entry_ptr = log.push_back(contains_x_call_entry_ptr, state::Set::make_ret(false)); insert_x_ret_entry_ptr = log.push_back(insert_x_call_entry_ptr, state::Set::make_ret(false)); EntryPtr entry_ptr, log_head_ptr{ log.log_head_ptr() }; assert(log_head_ptr == contains_x_call_entry_ptr); assert(log_head_ptr->prev == nullptr); assert(log_head_ptr->next == insert_x_call_entry_ptr); assert(log_head_ptr->match() == contains_x_ret_entry_ptr); entry_ptr = log_head_ptr->next; assert(entry_ptr == insert_x_call_entry_ptr); assert(entry_ptr->prev == contains_x_call_entry_ptr); assert(entry_ptr->next == contains_x_ret_entry_ptr); assert(entry_ptr->match() == insert_x_ret_entry_ptr); entry_ptr = entry_ptr->next; assert(entry_ptr == contains_x_ret_entry_ptr); assert(entry_ptr->prev == insert_x_call_entry_ptr); assert(entry_ptr->next == insert_x_ret_entry_ptr); assert(entry_ptr->match() == contains_x_call_entry_ptr); entry_ptr = entry_ptr->next; assert(entry_ptr == insert_x_ret_entry_ptr); assert(entry_ptr->prev == contains_x_ret_entry_ptr); assert(entry_ptr->next == nullptr); assert(entry_ptr->match() == insert_x_call_entry_ptr); LinearizabilityTester t{ log.info() }; assert(!t.check()); } struct WorkerConfiguration { const char max_value; const unsigned number_of_ops; }; static void returns_always_false_worker( const WorkerConfiguration& worker_configuration, ConcurrentLog& concurrent_log) { std::random_device rd; std::mt19937 gen(rd()); std::uniform_int_distribution<> value_dist('\0', worker_configuration.max_value); std::uniform_int_distribution<> percentage_dist(0, 100); // each operation returns false constexpr bool ret = false; char value; EntryPtr call_entry_ptr; for (unsigned number_of_ops{ 0U }; number_of_ops < worker_configuration.number_of_ops; ++number_of_ops) { value = value_dist(rd); if (percentage_dist(rd) < 30) { call_entry_ptr = concurrent_log.push_back(state::Set::make_insert_call(value)); concurrent_log.push_back(call_entry_ptr, state::Set::make_ret(ret)); } else if (percentage_dist(rd) < 50) { call_entry_ptr = concurrent_log.push_back(state::Set::make_erase_call(value)); concurrent_log.push_back(call_entry_ptr, state::Set::make_ret(ret)); } else { call_entry_ptr = concurrent_log.push_back(state::Set::make_contains_call(value)); concurrent_log.push_back(call_entry_ptr, state::Set::make_ret(ret)); } } } template void start_threads(unsigned number_of_threads, F&& f, Args&&... args) { std::vector threads(number_of_threads); for (Thread& thread : threads) thread = Thread(std::forward(f), std::forward(args)...); for (Thread& thread : threads) thread.join(); } /// The first "insert" operation should be always marked as non-linearizable. static void fuzzy_functional_test() { constexpr unsigned number_of_threads = 4U; constexpr WorkerConfiguration worker_configuration = { '\7', 12U }; constexpr unsigned log_size = number_of_threads * worker_configuration.number_of_ops; ConcurrentLog concurrent_log{ 2U * log_size }; // create history start_threads(number_of_threads, returns_always_false_worker, std::cref(worker_configuration), std::ref(concurrent_log)); LinearizabilityTester tester{ concurrent_log.info() }; assert(!tester.check()); } template static void embb_worker_stack( const WorkerConfiguration& worker_configuration, ConcurrentLog>& concurrent_log, S& concurrent_stack) { std::random_device rd; std::mt19937 gen(rd()); std::uniform_int_distribution<> value_dist('\0', worker_configuration.max_value); std::uniform_int_distribution<> percentage_dist(0, 100); // each operation returns false bool ret; char value; unsigned percentage; EntryPtr> call_entry_ptr; for (unsigned number_of_ops{ 0U }; number_of_ops < worker_configuration.number_of_ops; ++number_of_ops) { value = value_dist(rd); percentage = percentage_dist(rd); if (percentage < 30) { call_entry_ptr = concurrent_log.push_back(state::Stack::make_try_push_call(value)); ret = concurrent_stack.TryPush(value); concurrent_log.push_back(call_entry_ptr, state::Stack::make_try_push_ret(ret)); } else { call_entry_ptr = concurrent_log.push_back(state::Stack::make_try_pop_call()); ret = concurrent_stack.TryPop(value); concurrent_log.push_back(call_entry_ptr, state::Stack::make_try_pop_ret(ret, value)); } } } template static void embb_worker_queue( const WorkerConfiguration& worker_configuration, ConcurrentLog>& concurrent_log, S& concurrent_queue) { std::random_device rd; std::mt19937 gen(rd()); std::uniform_int_distribution<> value_dist('\0', worker_configuration.max_value); std::uniform_int_distribution<> percentage_dist(0, 100); // each operation returns false bool ret; char value; unsigned percentage; EntryPtr> call_entry_ptr; for (unsigned number_of_ops{ 0U }; number_of_ops < worker_configuration.number_of_ops; ++number_of_ops) { value = value_dist(rd); percentage = percentage_dist(rd); if (percentage < 20) { call_entry_ptr = concurrent_log.push_back(state::Queue::make_try_enqueue_call(value)); ret = concurrent_queue.TryEnqueue(value); concurrent_log.push_back(call_entry_ptr, state::Queue::make_try_enqueue_ret(ret)); } else { call_entry_ptr = concurrent_log.push_back(state::Queue::make_try_dequeue_call()); ret = concurrent_queue.TryDequeue(value); concurrent_log.push_back(call_entry_ptr, state::Queue::make_try_dequeue_ret(ret, value)); } } } template static void embb_experiment_stack(bool is_linearizable) { constexpr std::chrono::hours max_duration{ 1 }; constexpr std::size_t N = 560000U; constexpr unsigned number_of_threads = 4U; constexpr WorkerConfiguration worker_configuration = { '\24', 70000U }; constexpr unsigned log_size = number_of_threads * worker_configuration.number_of_ops; std::cout << "embb_experiment_stack : " << (is_linearizable ? "" : "!") << "linearizable" << std::endl; Result> result; ConcurrentLog> concurrent_log{ 2U * log_size }; S concurrent_stack(N); if (!is_linearizable) { bool ok = concurrent_stack.TryPush(5); assert(ok); } // create history start_threads(number_of_threads, embb_worker_stack, std::cref(worker_configuration), std::ref(concurrent_log), std::ref(concurrent_stack)); const std::size_t number_of_entries{ concurrent_log.number_of_entries() }; const LogInfo> log_info{ concurrent_log.info() }; // std::cout << log_info << std::endl; auto start = std::chrono::system_clock::now(); auto end = std::chrono::system_clock::now(); std::chrono::seconds seconds; start = std::chrono::system_clock::now(); { Log> log_copy{ log_info }; assert(log_copy.number_of_entries() == number_of_entries); LinearizabilityTester, Option::LRU_CACHE> tester{ log_copy.info(), max_duration }; tester.check(result); assert(result.is_timeout() || result.is_linearizable() == is_linearizable); } end = std::chrono::system_clock::now(); seconds = std::chrono::duration_cast(end - start); std::cout << "History length: " << number_of_entries << ", enabled state cache (LRU=on), O(1) hash: " << seconds.count() << " s " << std::endl; } template static void embb_experiment_queue(bool is_linearizable) { constexpr std::chrono::hours max_duration{ 1 }; constexpr std::size_t N = 560000U; constexpr unsigned number_of_threads = 4U; constexpr WorkerConfiguration worker_configuration = { '\24', 70000U }; constexpr unsigned log_size = number_of_threads * worker_configuration.number_of_ops; std::cout << "embb_experiment_queue : " << (is_linearizable ? "" : "!") << "linearizable" << std::endl; Result> result; ConcurrentLog> concurrent_log{ 2U * log_size }; S concurrent_queue(N); if (is_linearizable) { bool ok = concurrent_queue.TryEnqueue(5); assert(ok); } // create history start_threads(number_of_threads, embb_worker_queue, std::cref(worker_configuration), std::ref(concurrent_log), std::ref(concurrent_queue)); const std::size_t number_of_entries{ concurrent_log.number_of_entries() }; const LogInfo> log_info{ concurrent_log.info() }; // std::cout << log_info << std::endl; auto start = std::chrono::system_clock::now(); auto end = std::chrono::system_clock::now(); std::chrono::seconds seconds; start = std::chrono::system_clock::now(); { Log> log_copy{ log_info }; assert(log_copy.number_of_entries() == number_of_entries); LinearizabilityTester, Option::LRU_CACHE> tester{ log_copy.info(), max_duration }; tester.check(result); assert(result.is_timeout() || result.is_linearizable() == is_linearizable); } end = std::chrono::system_clock::now(); seconds = std::chrono::duration_cast(end - start); std::cout << "History length: " << number_of_entries << ", enabled state cache (LRU=on), O(1) hash: " << seconds.count() << " s " << std::endl; } int main() { test_lru_cache(); test_atomic_op(); test_stack(); test_state_set(); test_bitset(); test_state_set_op(); test_state_stack(); test_state_stack_op(); test_state_queue(); test_state_queue_op(); test_linearizability_empty_log(); test_raw_single_contains_is_linearizable(); test_raw_single_contains_is_not_linearizable(); test_log_copy(); test_single_contains(true); test_single_contains(false); // Consider a sequential insert(x) && contains(x) operation // && their return values on an initially empty set: for (bool a : {true, false}) for (bool b : {true, false}) { test_000(a, b); test_001(a, b); test_002(a, b); test_003(a, b); test_004(a, b); test_005(a, b); test_006(a, b); test_007(a, b); test_008(a, b); } // semantically deeper tests test_009(); test_010(); test_011(); test_012(); test_013(); test_014(); test_015(); test_016(); test_017(); test_018(); for (bool a : {true, false}) for (bool b : {true, false}) for (bool c : {true, false}) { test_019(a, b, c); test_020(a, b, c); } test_021(); test_stack_history_000(); test_stack_history_001(); test_stack_history_002(); test_stack_history_003(); test_slice_000(); test_slice_001(); #ifdef _LT_DEBUG_ // debug(); #endif concurrent_log(); fuzzy_functional_test(); embb::base::Thread::SetThreadsMaxCount(255); std::cout << "Linearizability experiment on LockFreeMPMCQueue" << std::endl; embb_experiment_queue>(true); std::cout << "Linearizability experiment on LockFreeStack" << std::endl; embb_experiment_stack>(true); return 0; }