snmalloc-sys 0.7.4

rust raw bindings of snmalloc.
Documentation
#pragma once

#include "../mem/mem.h"

namespace snmalloc
{
  /**
   * Example of type stored in the pagemap.
   * The following class could be replaced by:
   *
   * ```
   * using DefaultPagemapEntry = FrontendMetaEntry<FrontendSlabMetadata>;
   * ```
   *
   * The full form here provides an example of how to extend the pagemap
   * entries.  It also guarantees that the front end never directly
   * constructs meta entries, it only ever reads them or modifies them in
   * place.
   */
  template<typename SlabMetadata>
  class DefaultPagemapEntryT : public FrontendMetaEntry<SlabMetadata>
  {
    /**
     * The private initialising constructor is usable only by this back end.
     */
    template<
      SNMALLOC_CONCEPT(IsPAL) A1,
      typename A2,
      typename A3,
      typename A4,
      typename A5>
    friend class BackendAllocator;

    /**
     * The private default constructor is usable only by the pagemap.
     */
    template<size_t GRANULARITY_BITS, typename T, typename PAL, bool has_bounds>
    friend class FlatPagemap;

    /**
     * The only constructor that creates newly initialised meta entries.
     * This is callable only by the back end.  The front end may copy,
     * query, and update these entries, but it may not create them
     * directly.  This contract allows the back end to store any arbitrary
     * metadata in meta entries when they are first constructed.
     */
    SNMALLOC_FAST_PATH
    DefaultPagemapEntryT(SlabMetadata* meta, uintptr_t ras)
    : FrontendMetaEntry<SlabMetadata>(meta, ras)
    {}

    /**
     * Copy assignment is used only by the pagemap.
     */
    DefaultPagemapEntryT& operator=(const DefaultPagemapEntryT& other)
    {
      FrontendMetaEntry<SlabMetadata>::operator=(other);
      return *this;
    }

    /**
     * Default constructor.  This must be callable from the pagemap.
     */
    SNMALLOC_FAST_PATH DefaultPagemapEntryT() = default;
  };

  template<typename ClientMetaDataProvider>
  class DefaultSlabMetadata : public FrontendSlabMetadata<
                                DefaultSlabMetadata<ClientMetaDataProvider>,
                                ClientMetaDataProvider>
  {};

  template<typename ClientMetaDataProvider>
  using DefaultPagemapEntry =
    DefaultPagemapEntryT<DefaultSlabMetadata<ClientMetaDataProvider>>;

} // namespace snmalloc