quickcpplib::_xxx::mem_flush_loads_stores Namespace Reference

Namespaces
namespace	detail

Enumerations
enum class	memory_flush { memory_flush_none , memory_flush_retain , memory_flush_evict }
	The kinds of cache line flushing which can be performed. More...

Functions
memory_flush	mem_force_reload (const byte *data, size_t bytes, memory_flush kind=memory_flush_none, std::memory_order order=std::memory_order_acquire) noexcept
template<size_t N>
memory_flush	mem_force_reload (const byte(&region)[N], memory_flush kind=memory_flush_none, std::memory_order order=std::memory_order_acquire) noexcept
memory_flush	mem_flush_stores (const byte *data, size_t bytes, memory_flush kind=memory_flush_none, std::memory_order order=std::memory_order_release) noexcept
template<size_t N>
memory_flush	mem_flush_stores (const byte(&region)[N], memory_flush kind=memory_flush_none, std::memory_order order=std::memory_order_release) noexcept

Variables
constexpr memory_flush	memory_flush_none = memory_flush::memory_flush_none
	No memory flushing.
constexpr memory_flush	memory_flush_retain = memory_flush::memory_flush_retain
	Flush modified cache line to memory, but retain as unmodified in cache.
constexpr memory_flush	memory_flush_evict = memory_flush::memory_flush_evict
	Flush modified cache line to memory, and evict completely from all caches.

Enumeration Type Documentation

memory_flush

enum class quickcpplib::_xxx::mem_flush_loads_stores::memory_flush

strong

The kinds of cache line flushing which can be performed.

Enumerator
memory_flush_none	No memory flushing.
memory_flush_retain	Flush modified cache line to memory, but retain as unmodified in cache.
memory_flush_evict	Flush modified cache line to memory, and evict completely from all caches.

  {
    memory_flush_none,    //!< No memory flushing.
    memory_flush_retain,  //!< Flush modified cache line to memory, but retain as unmodified in cache.
    memory_flush_evict    //!< Flush modified cache line to memory, and evict completely from all caches.
  };

Function Documentation

mem_force_reload() [1/2]

memory_flush quickcpplib::_xxx::mem_flush_loads_stores::mem_force_reload ( const byte *  data, size_t  bytes, memory_flush  kind = memory_flush_none, std::memory_order  order = std::memory_order_acquire  )

inlinenoexcept

  {
    memory_flush ret = kind;
    // Ensure reload elimination does not occur on our region by calling a
    // potentially unknown external function which forces the compiler to
    // reload state after this call returns
    detail::potentially_unknown_jump()(data, bytes);
    if(memory_flush_evict == kind)
    {
      // TODO FIXME We assume a 64 byte cache line, which is bold.
      void *_data = (void *) (((uintptr_t) data) & ~63);
      size_t _bytes = ((uintptr_t) data + bytes + 63) - ((uintptr_t) _data);
      _bytes &= ~63;
      ret = detail::flush_impl()(_data, _bytes, kind);
    }
    // I really wish this would work on a region, not globally
    atomic_thread_fence(order);
    return ret;
  }

mem_force_reload() [2/2]

template<size_t N>

memory_flush quickcpplib::_xxx::mem_flush_loads_stores::mem_force_reload ( const byte(&)  region[N], memory_flush  kind = memory_flush_none, std::memory_order  order = std::memory_order_acquire  )

inlinenoexcept

  {
    return mem_force_reload(region, N, kind, order);
  }

mem_flush_stores() [1/2]

memory_flush quickcpplib::_xxx::mem_flush_loads_stores::mem_flush_stores ( const byte *  data, size_t  bytes, memory_flush  kind = memory_flush_none, std::memory_order  order = std::memory_order_release  )

inlinenoexcept

  {
    // I really wish this would work on a region, not globally
    atomic_thread_fence(order);
    // Ensure dead store elimination does not occur on our region by calling a
    // potentially unknown external function which forces the compiler to dump
    // out all pending writes before this call
    detail::potentially_unknown_jump()(data, bytes);
    if(memory_flush_none != kind)
    {
      // TODO FIXME We assume a 64 byte cache line, which is bold.
      void *_data = (void *) (((uintptr_t) data) & ~63);
      size_t _bytes = ((uintptr_t) data + bytes + 63) - ((uintptr_t) _data);
      _bytes &= ~63;
      memory_flush ret = detail::flush_impl()(_data, _bytes, kind);
      return ret;
    }
    return kind;
  }

mem_flush_stores() [2/2]

template<size_t N>

memory_flush quickcpplib::_xxx::mem_flush_loads_stores::mem_flush_stores ( const byte(&)  region[N], memory_flush  kind = memory_flush_none, std::memory_order  order = std::memory_order_release  )

inlinenoexcept

  {
    return mem_flush_stores(region, N, kind, order);
  }

Variable Documentation

memory_flush_none

constexpr memory_flush quickcpplib::_xxx::mem_flush_loads_stores::memory_flush_none = memory_flush::memory_flush_none

constexpr

No memory flushing.

memory_flush_retain

constexpr memory_flush quickcpplib::_xxx::mem_flush_loads_stores::memory_flush_retain = memory_flush::memory_flush_retain

constexpr

Flush modified cache line to memory, but retain as unmodified in cache.

memory_flush_evict

constexpr memory_flush quickcpplib::_xxx::mem_flush_loads_stores::memory_flush_evict = memory_flush::memory_flush_evict

constexpr

Flush modified cache line to memory, and evict completely from all caches.