Class NumaPolicy

Inheritance Relationships

Base Type

Class Documentation

class umpire::strategy::NumaPolicy : public umpire::strategy::AllocationStrategy

Use NUMA interface to locate memory to a specific NUMA node.

This AllocationStrategy provides a method of ensuring memory sits on a specific NUMA node. This can be used either for optimization, or for moving memory between the host and devices.

Public Functions

NumaPolicy(const std::string &name, int id, Allocator allocator, int numa_node)
void *allocate(std::size_t bytes) override

Allocate bytes of memory.


Pointer to start of allocated bytes.

  • bytes: Number of bytes to allocate.

void deallocate(void *ptr) override

Free the memory at ptr.

  • ptr: Pointer to free.

Platform getPlatform() noexcept override

Get the platform associated with this AllocationStrategy.

The Platform distinguishes the appropriate place to execute operations on memory allocated by this AllocationStrategy.


The platform associated with this AllocationStrategy.

MemoryResourceTraits getTraits() const noexcept override
int getNode() const noexcept
void release()

Release any and all unused memory held by this AllocationStrategy.

std::size_t getCurrentSize() const noexcept

Get current (total) size of the allocated memory.

This is the total size of all allocation currently ‘live’ that have been made by this AllocationStrategy object.


Current total size of allocations.

std::size_t getHighWatermark() const noexcept

Get the high watermark of the total allocated size.

This is equivalent to the highest observed value of getCurrentSize.


High watermark allocation size.

std::size_t getActualSize() const noexcept

Get the current amount of memory allocated by this allocator.

Note that this can be larger than getCurrentSize(), particularly if the AllocationStrategy implements some kind of pooling.


The total size of all the memory this object has allocated.

std::size_t getAllocationCount() const noexcept

Get the total number of active allocations by this allocator.


The total number of active allocations this object has allocated.

const std::string &getName() noexcept

Get the name of this AllocationStrategy.


The name of this AllocationStrategy.

int getId() noexcept

Get the id of this AllocationStrategy.


The id of this AllocationStrategy.

Protected Attributes

std::string m_name
int m_id