Device memory resource: raw device allocation (GPU::memAlloc / GPU::memFree). More...

#include <EBGeometry_MemoryResource.hpp>

Inheritance diagram for EBGeometry::DeviceMemoryResource:

Collaboration diagram for EBGeometry::DeviceMemoryResource:

Public Member Functions
	DeviceMemoryResource ()=default
	Default constructor.

	~DeviceMemoryResource () override=default
	Destructor.

void *	allocate (size_t a_bytes, size_t a_alignment) override
	Allocate a block of device memory.

void	deallocate (void *a_ptr, size_t a_bytes, size_t a_alignment) noexcept override
	Free a block previously returned by allocate.

bool	isHostAccessible () const noexcept override
	Device blocks are not host-accessible.

bool	isDeviceAccessible () const noexcept override
	Device blocks are device-accessible.

void	copy (void a_dst, const MemoryResource &a_dstResource, const void a_src, const MemoryResource &a_srcResource, size_t a_bytes) const noexcept override
	Copy between host and device memory with the GPU runtime; see MemoryResource::copy.

Public Member Functions inherited from EBGeometry::MemoryResource
	MemoryResource ()=default
	Default constructor.

virtual	~MemoryResource ()=default
	Destructor.

	MemoryResource (const MemoryResource &)=delete
	Copy constructor. Deleted: a resource's identity is meaningful and non-copyable.

MemoryResource &	operator= (const MemoryResource &)=delete
	Copy assignment. Deleted: a resource's identity is meaningful and non-copyable.

Detailed Description

Device memory resource: raw device allocation (GPU::memAlloc / GPU::memFree).

Compiled only under an offload backend (CUDA/HIP) or for documentation. Blocks are device-accessible and not host-accessible: a host pointer dereference of a returned block is undefined. The backend allocator already returns a base aligned to at least EBGeometry::PoolBaseAlign, so the requested alignment is only validated, not enforced.

Member Function Documentation

◆ allocate()

void * EBGeometry::DeviceMemoryResource::allocate	(	size_t	a_bytes,
		size_t	a_alignment
	)

overridevirtual

Allocate a block of device memory.

Parameters

[in]	a_bytes	Number of bytes to allocate.
[in]	a_alignment	Required alignment (validated to be <= PoolBaseAlign; the backend base already satisfies it).

Returns: Device pointer to the allocated block (never null on success; aborts on failure).

Implements EBGeometry::MemoryResource.

◆ copy()

void EBGeometry::DeviceMemoryResource::copy	(	void *	a_dst,
		const MemoryResource &	a_dstResource,
		const void *	a_src,
		const MemoryResource &	a_srcResource,
		size_t	a_bytes
	)		const

overridevirtualnoexcept

Copy between host and device memory with the GPU runtime; see MemoryResource::copy.

Host-to-host is a plain copy; device-to-device aborts, in every build.

Parameters

[out]	a_dst	Destination block.
[in]	a_dstResource	Resource that allocated a_dst.
[in]	a_src	Source block.
[in]	a_srcResource	Resource that allocated a_src.
[in]	a_bytes	Number of bytes to copy.