starpu_data_interfaces.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491
  1. /* StarPU --- Runtime system for heterogeneous multicore architectures.
  2. *
  3. * Copyright (C) 2010-2016 Université de Bordeaux
  4. * Copyright (C) 2010-2014, 2017 CNRS
  5. * Copyright (C) 2011-2012, 2016 INRIA
  6. *
  7. * StarPU is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU Lesser General Public License as published by
  9. * the Free Software Foundation; either version 2.1 of the License, or (at
  10. * your option) any later version.
  11. *
  12. * StarPU is distributed in the hope that it will be useful, but
  13. * WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  15. *
  16. * See the GNU Lesser General Public License in COPYING.LGPL for more details.
  17. */
  18. #ifndef __STARPU_DATA_INTERFACES_H__
  19. #define __STARPU_DATA_INTERFACES_H__
  20. #include <starpu.h>
  21. #ifdef STARPU_USE_CUDA
  22. /* to use CUDA streams */
  23. # ifdef STARPU_DONT_INCLUDE_CUDA_HEADERS
  24. typedef void *starpu_cudaStream_t;
  25. # else
  26. # include <cuda_runtime.h>
  27. typedef cudaStream_t starpu_cudaStream_t;
  28. # endif
  29. #endif
  30. #ifdef __cplusplus
  31. extern "C"
  32. {
  33. #endif
  34. struct starpu_data_copy_methods
  35. {
  36. int (*can_copy)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, unsigned handling_node);
  37. int (*ram_to_ram)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  38. int (*ram_to_cuda)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  39. int (*ram_to_opencl)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  40. int (*ram_to_mic)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  41. int (*cuda_to_ram)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  42. int (*cuda_to_cuda)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  43. int (*cuda_to_opencl)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  44. int (*opencl_to_ram)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  45. int (*opencl_to_cuda)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  46. int (*opencl_to_opencl)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  47. int (*mic_to_ram)(void *src_interface, unsigned srd_node, void *dst_interface, unsigned dst_node);
  48. int (*scc_src_to_sink)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  49. int (*scc_sink_to_src)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  50. int (*scc_sink_to_sink)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  51. int (*ram_to_mpi_ms)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  52. int (*mpi_ms_to_ram)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  53. int (*mpi_ms_to_mpi_ms)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  54. #ifdef STARPU_USE_CUDA
  55. int (*ram_to_cuda_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, starpu_cudaStream_t stream);
  56. int (*cuda_to_ram_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, starpu_cudaStream_t stream);
  57. int (*cuda_to_cuda_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, starpu_cudaStream_t stream);
  58. #else
  59. int (*ram_to_cuda_async)();
  60. int (*cuda_to_ram_async)();
  61. int (*cuda_to_cuda_async)();
  62. #endif
  63. #if defined(STARPU_USE_OPENCL) && !defined(__CUDACC__)
  64. int (*ram_to_opencl_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, cl_event *event);
  65. int (*opencl_to_ram_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, cl_event *event);
  66. int (*opencl_to_opencl_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, cl_event *event);
  67. #else
  68. int (*ram_to_opencl_async)();
  69. int (*opencl_to_ram_async)();
  70. int (*opencl_to_opencl_async)();
  71. #endif
  72. int (*ram_to_mpi_ms_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, void * event);
  73. int (*mpi_ms_to_ram_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, void * event);
  74. int (*mpi_ms_to_mpi_ms_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, void * event);
  75. int (*ram_to_mic_async)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node);
  76. int (*mic_to_ram_async)(void *src_interface, unsigned srd_node, void *dst_interface, unsigned dst_node);
  77. int (*any_to_any)(void *src_interface, unsigned src_node, void *dst_interface, unsigned dst_node, void *async_data);
  78. };
  79. int starpu_interface_copy(uintptr_t src, size_t src_offset, unsigned src_node, uintptr_t dst, size_t dst_offset, unsigned dst_node, size_t size, void *async_data);
  80. uintptr_t starpu_malloc_on_node_flags(unsigned dst_node, size_t size, int flags);
  81. uintptr_t starpu_malloc_on_node(unsigned dst_node, size_t size);
  82. void starpu_free_on_node_flags(unsigned dst_node, uintptr_t addr, size_t size, int flags);
  83. void starpu_free_on_node(unsigned dst_node, uintptr_t addr, size_t size);
  84. void starpu_malloc_on_node_set_default_flags(unsigned node, int flags);
  85. enum starpu_data_interface_id
  86. {
  87. STARPU_UNKNOWN_INTERFACE_ID = -1,
  88. STARPU_MATRIX_INTERFACE_ID=0,
  89. STARPU_BLOCK_INTERFACE_ID=1,
  90. STARPU_VECTOR_INTERFACE_ID=2,
  91. STARPU_CSR_INTERFACE_ID=3,
  92. STARPU_BCSR_INTERFACE_ID=4,
  93. STARPU_VARIABLE_INTERFACE_ID=5,
  94. STARPU_VOID_INTERFACE_ID=6,
  95. STARPU_MULTIFORMAT_INTERFACE_ID=7,
  96. STARPU_COO_INTERFACE_ID=8,
  97. STARPU_MAX_INTERFACE_ID=9
  98. };
  99. struct starpu_data_interface_ops
  100. {
  101. void (*register_data_handle) (starpu_data_handle_t handle,
  102. unsigned home_node, void *data_interface);
  103. starpu_ssize_t (*allocate_data_on_node) (void *data_interface, unsigned node);
  104. void (*free_data_on_node) (void *data_interface, unsigned node);
  105. const struct starpu_data_copy_methods *copy_methods;
  106. void * (*handle_to_pointer) (starpu_data_handle_t handle, unsigned node);
  107. size_t (*get_size) (starpu_data_handle_t handle);
  108. uint32_t (*footprint) (starpu_data_handle_t handle);
  109. int (*compare) (void *data_interface_a, void *data_interface_b);
  110. void (*display) (starpu_data_handle_t handle, FILE *f);
  111. starpu_ssize_t (*describe) (void *data_interface, char *buf, size_t size);
  112. enum starpu_data_interface_id interfaceid;
  113. size_t interface_size;
  114. char is_multiformat;
  115. char dontcache;
  116. struct starpu_multiformat_data_interface_ops* (*get_mf_ops)(void *data_interface);
  117. int (*pack_data) (starpu_data_handle_t handle, unsigned node, void **ptr, starpu_ssize_t *count);
  118. int (*unpack_data) (starpu_data_handle_t handle, unsigned node, void *ptr, size_t count);
  119. char *name;
  120. };
  121. int starpu_data_interface_get_next_id(void);
  122. void starpu_data_register(starpu_data_handle_t *handleptr, int home_node, void *data_interface, struct starpu_data_interface_ops *ops);
  123. void starpu_data_ptr_register(starpu_data_handle_t handle, unsigned node);
  124. void starpu_data_register_same(starpu_data_handle_t *handledst, starpu_data_handle_t handlesrc);
  125. void *starpu_data_handle_to_pointer(starpu_data_handle_t handle, unsigned node);
  126. void *starpu_data_get_local_ptr(starpu_data_handle_t handle);
  127. void *starpu_data_get_interface_on_node(starpu_data_handle_t handle, unsigned memory_node);
  128. extern struct starpu_data_interface_ops starpu_interface_matrix_ops;
  129. struct starpu_matrix_interface
  130. {
  131. enum starpu_data_interface_id id;
  132. uintptr_t ptr;
  133. uintptr_t dev_handle;
  134. size_t offset;
  135. uint32_t nx;
  136. uint32_t ny;
  137. uint32_t ld;
  138. size_t elemsize;
  139. };
  140. void starpu_matrix_data_register(starpu_data_handle_t *handle, int home_node, uintptr_t ptr, uint32_t ld, uint32_t nx, uint32_t ny, size_t elemsize);
  141. void starpu_matrix_ptr_register(starpu_data_handle_t handle, unsigned node, uintptr_t ptr, uintptr_t dev_handle, size_t offset, uint32_t ld);
  142. uint32_t starpu_matrix_get_nx(starpu_data_handle_t handle);
  143. uint32_t starpu_matrix_get_ny(starpu_data_handle_t handle);
  144. uint32_t starpu_matrix_get_local_ld(starpu_data_handle_t handle);
  145. uintptr_t starpu_matrix_get_local_ptr(starpu_data_handle_t handle);
  146. size_t starpu_matrix_get_elemsize(starpu_data_handle_t handle);
  147. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  148. #define STARPU_MATRIX_CHECK(interface) STARPU_ASSERT_MSG((((struct starpu_matrix_interface *)(interface))->id) == STARPU_MATRIX_INTERFACE_ID, "Error. The given data is not a matrix.")
  149. #define STARPU_MATRIX_GET_PTR(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->ptr) ; })
  150. #define STARPU_MATRIX_GET_DEV_HANDLE(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->dev_handle) ; })
  151. #define STARPU_MATRIX_GET_OFFSET(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->offset) ; })
  152. #define STARPU_MATRIX_GET_NX(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->nx) ; })
  153. #define STARPU_MATRIX_GET_NY(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->ny) ; })
  154. #define STARPU_MATRIX_GET_LD(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->ld) ; })
  155. #define STARPU_MATRIX_GET_ELEMSIZE(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->elemsize) ; })
  156. #else
  157. #define STARPU_MATRIX_GET_PTR(interface) (((struct starpu_matrix_interface *)(interface))->ptr)
  158. #define STARPU_MATRIX_GET_DEV_HANDLE(interface) (((struct starpu_matrix_interface *)(interface))->dev_handle)
  159. #define STARPU_MATRIX_GET_OFFSET(interface) (((struct starpu_matrix_interface *)(interface))->offset)
  160. #define STARPU_MATRIX_GET_NX(interface) (((struct starpu_matrix_interface *)(interface))->nx)
  161. #define STARPU_MATRIX_GET_NY(interface) (((struct starpu_matrix_interface *)(interface))->ny)
  162. #define STARPU_MATRIX_GET_LD(interface) (((struct starpu_matrix_interface *)(interface))->ld)
  163. #define STARPU_MATRIX_GET_ELEMSIZE(interface) (((struct starpu_matrix_interface *)(interface))->elemsize)
  164. #endif
  165. extern struct starpu_data_interface_ops starpu_interface_coo_ops;
  166. struct starpu_coo_interface
  167. {
  168. enum starpu_data_interface_id id;
  169. uint32_t *columns;
  170. uint32_t *rows;
  171. uintptr_t values;
  172. uint32_t nx;
  173. uint32_t ny;
  174. uint32_t n_values;
  175. size_t elemsize;
  176. };
  177. void starpu_coo_data_register(starpu_data_handle_t *handleptr, int home_node, uint32_t nx, uint32_t ny, uint32_t n_values, uint32_t *columns, uint32_t *rows, uintptr_t values, size_t elemsize);
  178. #define STARPU_COO_GET_COLUMNS(interface) \
  179. (((struct starpu_coo_interface *)(interface))->columns)
  180. #define STARPU_COO_GET_COLUMNS_DEV_HANDLE(interface) \
  181. (((struct starpu_coo_interface *)(interface))->columns)
  182. #define STARPU_COO_GET_ROWS(interface) \
  183. (((struct starpu_coo_interface *)(interface))->rows)
  184. #define STARPU_COO_GET_ROWS_DEV_HANDLE(interface) \
  185. (((struct starpu_coo_interface *)(interface))->rows)
  186. #define STARPU_COO_GET_VALUES(interface) \
  187. (((struct starpu_coo_interface *)(interface))->values)
  188. #define STARPU_COO_GET_VALUES_DEV_HANDLE(interface) \
  189. (((struct starpu_coo_interface *)(interface))->values)
  190. #define STARPU_COO_GET_OFFSET 0
  191. #define STARPU_COO_GET_NX(interface) \
  192. (((struct starpu_coo_interface *)(interface))->nx)
  193. #define STARPU_COO_GET_NY(interface) \
  194. (((struct starpu_coo_interface *)(interface))->ny)
  195. #define STARPU_COO_GET_NVALUES(interface) \
  196. (((struct starpu_coo_interface *)(interface))->n_values)
  197. #define STARPU_COO_GET_ELEMSIZE(interface) \
  198. (((struct starpu_coo_interface *)(interface))->elemsize)
  199. extern struct starpu_data_interface_ops starpu_interface_block_ops;
  200. /* TODO: rename to 3dmatrix? */
  201. struct starpu_block_interface
  202. {
  203. enum starpu_data_interface_id id;
  204. uintptr_t ptr;
  205. uintptr_t dev_handle;
  206. size_t offset;
  207. uint32_t nx;
  208. uint32_t ny;
  209. uint32_t nz;
  210. uint32_t ldy;
  211. uint32_t ldz;
  212. size_t elemsize;
  213. };
  214. void starpu_block_data_register(starpu_data_handle_t *handle, int home_node, uintptr_t ptr, uint32_t ldy, uint32_t ldz, uint32_t nx, uint32_t ny, uint32_t nz, size_t elemsize);
  215. void starpu_block_ptr_register(starpu_data_handle_t handle, unsigned node, uintptr_t ptr, uintptr_t dev_handle, size_t offset, uint32_t ldy, uint32_t ldz);
  216. uint32_t starpu_block_get_nx(starpu_data_handle_t handle);
  217. uint32_t starpu_block_get_ny(starpu_data_handle_t handle);
  218. uint32_t starpu_block_get_nz(starpu_data_handle_t handle);
  219. uint32_t starpu_block_get_local_ldy(starpu_data_handle_t handle);
  220. uint32_t starpu_block_get_local_ldz(starpu_data_handle_t handle);
  221. uintptr_t starpu_block_get_local_ptr(starpu_data_handle_t handle);
  222. size_t starpu_block_get_elemsize(starpu_data_handle_t handle);
  223. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  224. #define STARPU_BLOCK_CHECK(interface) STARPU_ASSERT_MSG((((struct starpu_block_interface *)(interface))->id) == STARPU_BLOCK_INTERFACE_ID, "Error. The given data is not a block.")
  225. #define STARPU_BLOCK_GET_PTR(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ptr) ; })
  226. #define STARPU_BLOCK_GET_DEV_HANDLE(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->dev_handle) ; })
  227. #define STARPU_BLOCK_GET_OFFSET(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->offset) ; })
  228. #define STARPU_BLOCK_GET_NX(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->nx) ; })
  229. #define STARPU_BLOCK_GET_NY(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ny) ; })
  230. #define STARPU_BLOCK_GET_NZ(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->nz) ; })
  231. #define STARPU_BLOCK_GET_LDY(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ldy) ; })
  232. #define STARPU_BLOCK_GET_LDZ(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ldz) ; })
  233. #define STARPU_BLOCK_GET_ELEMSIZE(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->elemsize) ; })
  234. #else
  235. #define STARPU_BLOCK_GET_PTR(interface) (((struct starpu_block_interface *)(interface))->ptr)
  236. #define STARPU_BLOCK_GET_DEV_HANDLE(interface) (((struct starpu_block_interface *)(interface))->dev_handle)
  237. #define STARPU_BLOCK_GET_OFFSET(interface) (((struct starpu_block_interface *)(interface))->offset)
  238. #define STARPU_BLOCK_GET_NX(interface) (((struct starpu_block_interface *)(interface))->nx)
  239. #define STARPU_BLOCK_GET_NY(interface) (((struct starpu_block_interface *)(interface))->ny)
  240. #define STARPU_BLOCK_GET_NZ(interface) (((struct starpu_block_interface *)(interface))->nz)
  241. #define STARPU_BLOCK_GET_LDY(interface) (((struct starpu_block_interface *)(interface))->ldy)
  242. #define STARPU_BLOCK_GET_LDZ(interface) (((struct starpu_block_interface *)(interface))->ldz)
  243. #define STARPU_BLOCK_GET_ELEMSIZE(interface) (((struct starpu_block_interface *)(interface))->elemsize)
  244. #endif
  245. extern struct starpu_data_interface_ops starpu_interface_vector_ops;
  246. struct starpu_vector_interface
  247. {
  248. enum starpu_data_interface_id id;
  249. uintptr_t ptr;
  250. uintptr_t dev_handle;
  251. size_t offset;
  252. uint32_t nx;
  253. size_t elemsize;
  254. uint32_t slice_base;
  255. };
  256. void starpu_vector_data_register(starpu_data_handle_t *handle, int home_node, uintptr_t ptr, uint32_t nx, size_t elemsize);
  257. void starpu_vector_ptr_register(starpu_data_handle_t handle, unsigned node, uintptr_t ptr, uintptr_t dev_handle, size_t offset);
  258. uint32_t starpu_vector_get_nx(starpu_data_handle_t handle);
  259. size_t starpu_vector_get_elemsize(starpu_data_handle_t handle);
  260. uintptr_t starpu_vector_get_local_ptr(starpu_data_handle_t handle);
  261. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  262. #define STARPU_VECTOR_CHECK(interface) STARPU_ASSERT_MSG((((struct starpu_vector_interface *)(interface))->id) == STARPU_VECTOR_INTERFACE_ID, "Error. The given data is not a vector.")
  263. #define STARPU_VECTOR_GET_PTR(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->ptr); })
  264. #define STARPU_VECTOR_GET_DEV_HANDLE(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->dev_handle); })
  265. #define STARPU_VECTOR_GET_OFFSET(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->offset); })
  266. #define STARPU_VECTOR_GET_NX(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->nx); })
  267. #define STARPU_VECTOR_GET_ELEMSIZE(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->elemsize); })
  268. #define STARPU_VECTOR_GET_SLICE_BASE(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->slice_base); })
  269. #else
  270. #define STARPU_VECTOR_GET_PTR(interface) (((struct starpu_vector_interface *)(interface))->ptr)
  271. #define STARPU_VECTOR_GET_DEV_HANDLE(interface) (((struct starpu_vector_interface *)(interface))->dev_handle)
  272. #define STARPU_VECTOR_GET_OFFSET(interface) (((struct starpu_vector_interface *)(interface))->offset)
  273. #define STARPU_VECTOR_GET_NX(interface) (((struct starpu_vector_interface *)(interface))->nx)
  274. #define STARPU_VECTOR_GET_ELEMSIZE(interface) (((struct starpu_vector_interface *)(interface))->elemsize)
  275. #define STARPU_VECTOR_GET_SLICE_BASE(interface) (((struct starpu_vector_interface *)(interface))->slice_base)
  276. #endif
  277. extern struct starpu_data_interface_ops starpu_interface_variable_ops;
  278. struct starpu_variable_interface
  279. {
  280. enum starpu_data_interface_id id;
  281. uintptr_t ptr;
  282. uintptr_t dev_handle;
  283. size_t offset;
  284. size_t elemsize;
  285. };
  286. void starpu_variable_data_register(starpu_data_handle_t *handle, int home_node, uintptr_t ptr, size_t size);
  287. void starpu_variable_ptr_register(starpu_data_handle_t handle, unsigned node, uintptr_t ptr, uintptr_t dev_handle, size_t offset);
  288. size_t starpu_variable_get_elemsize(starpu_data_handle_t handle);
  289. uintptr_t starpu_variable_get_local_ptr(starpu_data_handle_t handle);
  290. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  291. #define STARPU_VARIABLE_CHECK(interface) STARPU_ASSERT_MSG((((struct starpu_variable_interface *)(interface))->id) == STARPU_VARIABLE_INTERFACE_ID, "Error. The given data is not a variable.")
  292. #define STARPU_VARIABLE_GET_PTR(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->ptr) ; })
  293. #define STARPU_VARIABLE_GET_OFFSET(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->offset) ; })
  294. #define STARPU_VARIABLE_GET_ELEMSIZE(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->elemsize) ; })
  295. #define STARPU_VARIABLE_GET_DEV_HANDLE(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->ptr) ; })
  296. #else
  297. #define STARPU_VARIABLE_GET_PTR(interface) (((struct starpu_variable_interface *)(interface))->ptr)
  298. #define STARPU_VARIABLE_GET_OFFSET(interface) (((struct starpu_variable_interface *)(interface))->offset)
  299. #define STARPU_VARIABLE_GET_ELEMSIZE(interface) (((struct starpu_variable_interface *)(interface))->elemsize)
  300. #define STARPU_VARIABLE_GET_DEV_HANDLE(interface) (((struct starpu_variable_interface *)(interface))->ptr)
  301. #endif
  302. extern struct starpu_data_interface_ops starpu_interface_void_ops;
  303. void starpu_void_data_register(starpu_data_handle_t *handle);
  304. extern struct starpu_data_interface_ops starpu_interface_csr_ops;
  305. struct starpu_csr_interface
  306. {
  307. enum starpu_data_interface_id id;
  308. uint32_t nnz;
  309. uint32_t nrow;
  310. uintptr_t nzval;
  311. uint32_t *colind;
  312. uint32_t *rowptr;
  313. uint32_t firstentry;
  314. size_t elemsize;
  315. };
  316. void starpu_csr_data_register(starpu_data_handle_t *handle, int home_node, uint32_t nnz, uint32_t nrow, uintptr_t nzval, uint32_t *colind, uint32_t *rowptr, uint32_t firstentry, size_t elemsize);
  317. uint32_t starpu_csr_get_nnz(starpu_data_handle_t handle);
  318. uint32_t starpu_csr_get_nrow(starpu_data_handle_t handle);
  319. uint32_t starpu_csr_get_firstentry(starpu_data_handle_t handle);
  320. uintptr_t starpu_csr_get_local_nzval(starpu_data_handle_t handle);
  321. uint32_t *starpu_csr_get_local_colind(starpu_data_handle_t handle);
  322. uint32_t *starpu_csr_get_local_rowptr(starpu_data_handle_t handle);
  323. size_t starpu_csr_get_elemsize(starpu_data_handle_t handle);
  324. #define STARPU_CSR_GET_NNZ(interface) (((struct starpu_csr_interface *)(interface))->nnz)
  325. #define STARPU_CSR_GET_NROW(interface) (((struct starpu_csr_interface *)(interface))->nrow)
  326. #define STARPU_CSR_GET_NZVAL(interface) (((struct starpu_csr_interface *)(interface))->nzval)
  327. #define STARPU_CSR_GET_NZVAL_DEV_HANDLE(interface) \
  328. (((struct starpu_csr_interface *)(interface))->nnz)
  329. #define STARPU_CSR_GET_COLIND(interface) (((struct starpu_csr_interface *)(interface))->colind)
  330. #define STARPU_CSR_GET_COLIND_DEV_HANDLE(interface) \
  331. (((struct starpu_csr_interface *)(interface))->colind)
  332. #define STARPU_CSR_GET_ROWPTR(interface) (((struct starpu_csr_interface *)(interface))->rowptr)
  333. #define STARPU_CSR_GET_ROWPTR_DEV_HANDLE(interface) \
  334. (((struct starpu_csr_interface *)(interface))->rowptr)
  335. #define STARPU_CSR_GET_OFFSET 0
  336. #define STARPU_CSR_GET_FIRSTENTRY(interface) (((struct starpu_csr_interface *)(interface))->firstentry)
  337. #define STARPU_CSR_GET_ELEMSIZE(interface) (((struct starpu_csr_interface *)(interface))->elemsize)
  338. extern struct starpu_data_interface_ops starpu_interface_bcsr_ops;
  339. struct starpu_bcsr_interface
  340. {
  341. enum starpu_data_interface_id id;
  342. uint32_t nnz;
  343. uint32_t nrow;
  344. uintptr_t nzval;
  345. uint32_t *colind;
  346. uint32_t *rowptr;
  347. uint32_t firstentry;
  348. uint32_t r;
  349. uint32_t c;
  350. size_t elemsize;
  351. };
  352. void starpu_bcsr_data_register(starpu_data_handle_t *handle, int home_node, uint32_t nnz, uint32_t nrow, uintptr_t nzval, uint32_t *colind, uint32_t *rowptr, uint32_t firstentry, uint32_t r, uint32_t c, size_t elemsize);
  353. #define STARPU_BCSR_GET_NNZ(interface) (((struct starpu_bcsr_interface *)(interface))->nnz)
  354. #define STARPU_BCSR_GET_NZVAL(interface) (((struct starpu_bcsr_interface *)(interface))->nzval)
  355. #define STARPU_BCSR_GET_NZVAL_DEV_HANDLE(interface) \
  356. (((struct starpu_bcsr_interface *)(interface))->nnz)
  357. #define STARPU_BCSR_GET_COLIND(interface) (((struct starpu_bcsr_interface *)(interface))->colind)
  358. #define STARPU_BCSR_GET_COLIND_DEV_HANDLE(interface) \
  359. (((struct starpu_bcsr_interface *)(interface))->colind)
  360. #define STARPU_BCSR_GET_ROWPTR(interface) (((struct starpu_bcsr_interface *)(interface))->rowptr)
  361. #define STARPU_BCSR_GET_ROWPTR_DEV_HANDLE(interface) \
  362. (((struct starpu_bcsr_interface *)(interface))->rowptr)
  363. #define STARPU_BCSR_GET_OFFSET 0
  364. uint32_t starpu_bcsr_get_nnz(starpu_data_handle_t handle);
  365. uint32_t starpu_bcsr_get_nrow(starpu_data_handle_t handle);
  366. uint32_t starpu_bcsr_get_firstentry(starpu_data_handle_t handle);
  367. uintptr_t starpu_bcsr_get_local_nzval(starpu_data_handle_t handle);
  368. uint32_t *starpu_bcsr_get_local_colind(starpu_data_handle_t handle);
  369. uint32_t *starpu_bcsr_get_local_rowptr(starpu_data_handle_t handle);
  370. uint32_t starpu_bcsr_get_r(starpu_data_handle_t handle);
  371. uint32_t starpu_bcsr_get_c(starpu_data_handle_t handle);
  372. size_t starpu_bcsr_get_elemsize(starpu_data_handle_t handle);
  373. struct starpu_multiformat_data_interface_ops
  374. {
  375. size_t cpu_elemsize;
  376. size_t opencl_elemsize;
  377. struct starpu_codelet *cpu_to_opencl_cl;
  378. struct starpu_codelet *opencl_to_cpu_cl;
  379. size_t cuda_elemsize;
  380. struct starpu_codelet *cpu_to_cuda_cl;
  381. struct starpu_codelet *cuda_to_cpu_cl;
  382. size_t mic_elemsize;
  383. struct starpu_codelet *cpu_to_mic_cl;
  384. struct starpu_codelet *mic_to_cpu_cl;
  385. };
  386. struct starpu_multiformat_interface
  387. {
  388. enum starpu_data_interface_id id;
  389. void *cpu_ptr;
  390. void *cuda_ptr;
  391. void *opencl_ptr;
  392. void *mic_ptr;
  393. uint32_t nx;
  394. struct starpu_multiformat_data_interface_ops *ops;
  395. };
  396. void starpu_multiformat_data_register(starpu_data_handle_t *handle, int home_node, void *ptr, uint32_t nobjects, struct starpu_multiformat_data_interface_ops *format_ops);
  397. #define STARPU_MULTIFORMAT_GET_CPU_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->cpu_ptr)
  398. #define STARPU_MULTIFORMAT_GET_CUDA_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->cuda_ptr)
  399. #define STARPU_MULTIFORMAT_GET_OPENCL_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->opencl_ptr)
  400. #define STARPU_MULTIFORMAT_GET_MIC_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->mic_ptr)
  401. #define STARPU_MULTIFORMAT_GET_NX(interface) (((struct starpu_multiformat_interface *)(interface))->nx)
  402. enum starpu_data_interface_id starpu_data_get_interface_id(starpu_data_handle_t handle);
  403. int starpu_data_pack(starpu_data_handle_t handle, void **ptr, starpu_ssize_t *count);
  404. int starpu_data_unpack(starpu_data_handle_t handle, void *ptr, size_t count);
  405. size_t starpu_data_get_size(starpu_data_handle_t handle);
  406. starpu_data_handle_t starpu_data_lookup(const void *ptr);
  407. #ifdef __cplusplus
  408. }
  409. #endif
  410. #endif /* __STARPU_DATA_INTERFACES_H__ */