cuda::experimental::stf::void_graph_interface

Defined in include/cuda/experimental/__stf/internal/void_interface.cuh

class void_graph_interface : public cuda::experimental::stf::graph_data_interface<void_interface>

Data interface to manipulate the void interface in the CUDA graph backend.

Public Types

using base = graph_data_interface<void_interface>

Alias for the base class.

using shape_t = typename base::shape_t
using element_type = void_interface

Public Functions

inline void_graph_interface(void_interface s)
inline void_graph_interface(shape_of<void_interface> s)
inline virtual void data_allocate(backend_ctx_untyped&, block_allocator_untyped&, const data_place&, instance_id_t, ::std::ptrdiff_t &s, void**, event_list&) override

Allocate data and return a prerequisite event list.

Parameters

  • ctx – Backend context state

  • memory_node – The memory node where the data is stored

  • instance_id – The ID of the data instance

  • s – Pointer to the size of the allocated data

  • extra_args – Additional arguments required for allocation

  • prereqs – Prerequisite event list, will be updated as a side effect

inline virtual void data_deallocate(backend_ctx_untyped&, block_allocator_untyped&, const data_place&, instance_id_t, void*, event_list&) final

Deallocate data and return a prerequisite event list.

Parameters

  • ctx – Backend context state

  • memory_node – The memory node where the data is stored

  • instance_id – The ID of the data instance

  • extra_args – Additional arguments required for deallocation

  • prereqs – Prerequisite event list, will be updated as a side effect

inline virtual cudaGraphNode_t graph_data_copy(cudaMemcpyKind, instance_id_t, instance_id_t, cudaGraph_t graph, const cudaGraphNode_t *input_nodes, size_t input_cnt) override
inline virtual bool pin_host_memory(instance_id_t) override

Pin host memory.

Parameters

instance_id – The ID of the data instance

Returns

true if the instance was pinned, false otherwise

inline virtual void unpin_host_memory(instance_id_t) override

Unpin host memory.

Parameters

instance_id – The ID of the data instance

inline virtual void data_copy(backend_ctx_untyped &ctx_, const data_place &dst_memory_node, instance_id_t dst_instance_id, const data_place &src_memory_node, instance_id_t src_instance_id, event_list &prereqs) override

Copy data from one memory node to another, returning a prerequisite event list.

Parameters

  • ctx – Backend context state

  • dst_memory_node – The destination memory node

  • dst_instance_id – The destination instance ID

  • src_memory_node – The source memory node

  • src_instance_id – The source instance ID

  • arg – Additional arguments required for copying data

  • prereqs – Prerequisite event list, will be updated as a side effect

template<typename T>
inline const T &shape() const

Get the part of the data interface that is common to all data instances.

Template Parameters

T – The type of the data shape

Returns

A const reference to the data shape

inline void_interface &instance(instance_id_t instance_id)
inline const void_interface &instance(instance_id_t instance_id) const
inline virtual size_t data_hash(instance_id_t instance_id) const final

Get the hash of the data representation for the given instance ID.

Parameters

instance_id – The ID of the data instance

Returns

The hash of the data representation

inline size_t data_footprint() const final
inline ::std::optional<cudaMemoryType> get_memory_type(instance_id_t)
template<typename T>
inline const T &instance_const(instance_id_t instance_id) const

Get a const reference to the data instance of the given ID.

Template Parameters

T – The type of the data instance

Parameters

instance_id – The ID of the data instance

Returns

A const reference to the data instance

template<typename backend_ctx_untyped>
inline instance_id_t get_default_instance_id(backend_ctx_untyped&, const logical_data_untyped &d, task &tp) const

Returns the index (ID) of the data instance for this logical data in the current task context.

If this is called outside a task, this will result in an error.

Parameters

  • ctx – The backend context state

  • d – The logical data_untyped

Returns

The ID of the data instance for this logical data

Protected Attributes

const shape_t shape
const void_interface prototype
::std::deque<void_interface> store