starpu_data_interfaces.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498
  1. /* StarPU --- Runtime system for heterogeneous multicore architectures.
  2. *
  3. * Copyright (C) 2011-2014,2016-2017 Inria
  4. * Copyright (C) 2009-2016,2018 Université de Bordeaux
  5. * Copyright (C) 2010-2015,2017 CNRS
  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. void starpu_interface_start_driver_copy_async(unsigned src_node, unsigned dst_node, double *start);
  81. void starpu_interface_end_driver_copy_async(unsigned src_node, unsigned dst_node, double start);
  82. uintptr_t starpu_malloc_on_node_flags(unsigned dst_node, size_t size, int flags);
  83. uintptr_t starpu_malloc_on_node(unsigned dst_node, size_t size);
  84. void starpu_free_on_node_flags(unsigned dst_node, uintptr_t addr, size_t size, int flags);
  85. void starpu_free_on_node(unsigned dst_node, uintptr_t addr, size_t size);
  86. void starpu_malloc_on_node_set_default_flags(unsigned node, int flags);
  87. enum starpu_data_interface_id
  88. {
  89. STARPU_UNKNOWN_INTERFACE_ID = -1,
  90. STARPU_MATRIX_INTERFACE_ID=0,
  91. STARPU_BLOCK_INTERFACE_ID=1,
  92. STARPU_VECTOR_INTERFACE_ID=2,
  93. STARPU_CSR_INTERFACE_ID=3,
  94. STARPU_BCSR_INTERFACE_ID=4,
  95. STARPU_VARIABLE_INTERFACE_ID=5,
  96. STARPU_VOID_INTERFACE_ID=6,
  97. STARPU_MULTIFORMAT_INTERFACE_ID=7,
  98. STARPU_COO_INTERFACE_ID=8,
  99. STARPU_MAX_INTERFACE_ID=9
  100. };
  101. struct starpu_data_interface_ops
  102. {
  103. void (*register_data_handle) (starpu_data_handle_t handle,
  104. unsigned home_node, void *data_interface);
  105. starpu_ssize_t (*allocate_data_on_node) (void *data_interface, unsigned node);
  106. void (*free_data_on_node) (void *data_interface, unsigned node);
  107. const struct starpu_data_copy_methods *copy_methods;
  108. void * (*handle_to_pointer) (starpu_data_handle_t handle, unsigned node); /* deprecated */
  109. void * (*to_pointer) (void *data_interface, unsigned node);
  110. int (*pointer_is_inside) (void *data_interface, unsigned node, void *ptr);
  111. size_t (*get_size) (starpu_data_handle_t handle);
  112. uint32_t (*footprint) (starpu_data_handle_t handle);
  113. int (*compare) (void *data_interface_a, void *data_interface_b);
  114. void (*display) (starpu_data_handle_t handle, FILE *f);
  115. starpu_ssize_t (*describe) (void *data_interface, char *buf, size_t size);
  116. enum starpu_data_interface_id interfaceid;
  117. size_t interface_size;
  118. char is_multiformat;
  119. char dontcache;
  120. struct starpu_multiformat_data_interface_ops* (*get_mf_ops)(void *data_interface);
  121. int (*pack_data) (starpu_data_handle_t handle, unsigned node, void **ptr, starpu_ssize_t *count);
  122. int (*unpack_data) (starpu_data_handle_t handle, unsigned node, void *ptr, size_t count);
  123. char *name;
  124. };
  125. int starpu_data_interface_get_next_id(void);
  126. void starpu_data_register(starpu_data_handle_t *handleptr, int home_node, void *data_interface, struct starpu_data_interface_ops *ops);
  127. void starpu_data_ptr_register(starpu_data_handle_t handle, unsigned node);
  128. void starpu_data_register_same(starpu_data_handle_t *handledst, starpu_data_handle_t handlesrc);
  129. void *starpu_data_handle_to_pointer(starpu_data_handle_t handle, unsigned node);
  130. int starpu_data_pointer_is_inside(starpu_data_handle_t handle, unsigned node, void *ptr);
  131. void *starpu_data_get_local_ptr(starpu_data_handle_t handle);
  132. void *starpu_data_get_interface_on_node(starpu_data_handle_t handle, unsigned memory_node);
  133. extern struct starpu_data_interface_ops starpu_interface_matrix_ops;
  134. struct starpu_matrix_interface
  135. {
  136. enum starpu_data_interface_id id;
  137. uintptr_t ptr;
  138. uintptr_t dev_handle;
  139. size_t offset;
  140. uint32_t nx;
  141. uint32_t ny;
  142. uint32_t ld;
  143. size_t elemsize;
  144. };
  145. 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);
  146. 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);
  147. uint32_t starpu_matrix_get_nx(starpu_data_handle_t handle);
  148. uint32_t starpu_matrix_get_ny(starpu_data_handle_t handle);
  149. uint32_t starpu_matrix_get_local_ld(starpu_data_handle_t handle);
  150. uintptr_t starpu_matrix_get_local_ptr(starpu_data_handle_t handle);
  151. size_t starpu_matrix_get_elemsize(starpu_data_handle_t handle);
  152. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  153. #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.")
  154. #define STARPU_MATRIX_GET_PTR(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->ptr) ; })
  155. #define STARPU_MATRIX_GET_DEV_HANDLE(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->dev_handle) ; })
  156. #define STARPU_MATRIX_GET_OFFSET(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->offset) ; })
  157. #define STARPU_MATRIX_GET_NX(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->nx) ; })
  158. #define STARPU_MATRIX_GET_NY(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->ny) ; })
  159. #define STARPU_MATRIX_GET_LD(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->ld) ; })
  160. #define STARPU_MATRIX_GET_ELEMSIZE(interface) ({ STARPU_MATRIX_CHECK(interface); (((struct starpu_matrix_interface *)(interface))->elemsize) ; })
  161. #else
  162. #define STARPU_MATRIX_GET_PTR(interface) (((struct starpu_matrix_interface *)(interface))->ptr)
  163. #define STARPU_MATRIX_GET_DEV_HANDLE(interface) (((struct starpu_matrix_interface *)(interface))->dev_handle)
  164. #define STARPU_MATRIX_GET_OFFSET(interface) (((struct starpu_matrix_interface *)(interface))->offset)
  165. #define STARPU_MATRIX_GET_NX(interface) (((struct starpu_matrix_interface *)(interface))->nx)
  166. #define STARPU_MATRIX_GET_NY(interface) (((struct starpu_matrix_interface *)(interface))->ny)
  167. #define STARPU_MATRIX_GET_LD(interface) (((struct starpu_matrix_interface *)(interface))->ld)
  168. #define STARPU_MATRIX_GET_ELEMSIZE(interface) (((struct starpu_matrix_interface *)(interface))->elemsize)
  169. #endif
  170. extern struct starpu_data_interface_ops starpu_interface_coo_ops;
  171. struct starpu_coo_interface
  172. {
  173. enum starpu_data_interface_id id;
  174. uint32_t *columns;
  175. uint32_t *rows;
  176. uintptr_t values;
  177. uint32_t nx;
  178. uint32_t ny;
  179. uint32_t n_values;
  180. size_t elemsize;
  181. };
  182. 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);
  183. #define STARPU_COO_GET_COLUMNS(interface) \
  184. (((struct starpu_coo_interface *)(interface))->columns)
  185. #define STARPU_COO_GET_COLUMNS_DEV_HANDLE(interface) \
  186. (((struct starpu_coo_interface *)(interface))->columns)
  187. #define STARPU_COO_GET_ROWS(interface) \
  188. (((struct starpu_coo_interface *)(interface))->rows)
  189. #define STARPU_COO_GET_ROWS_DEV_HANDLE(interface) \
  190. (((struct starpu_coo_interface *)(interface))->rows)
  191. #define STARPU_COO_GET_VALUES(interface) \
  192. (((struct starpu_coo_interface *)(interface))->values)
  193. #define STARPU_COO_GET_VALUES_DEV_HANDLE(interface) \
  194. (((struct starpu_coo_interface *)(interface))->values)
  195. #define STARPU_COO_GET_OFFSET 0
  196. #define STARPU_COO_GET_NX(interface) \
  197. (((struct starpu_coo_interface *)(interface))->nx)
  198. #define STARPU_COO_GET_NY(interface) \
  199. (((struct starpu_coo_interface *)(interface))->ny)
  200. #define STARPU_COO_GET_NVALUES(interface) \
  201. (((struct starpu_coo_interface *)(interface))->n_values)
  202. #define STARPU_COO_GET_ELEMSIZE(interface) \
  203. (((struct starpu_coo_interface *)(interface))->elemsize)
  204. extern struct starpu_data_interface_ops starpu_interface_block_ops;
  205. /* TODO: rename to 3dmatrix? */
  206. struct starpu_block_interface
  207. {
  208. enum starpu_data_interface_id id;
  209. uintptr_t ptr;
  210. uintptr_t dev_handle;
  211. size_t offset;
  212. uint32_t nx;
  213. uint32_t ny;
  214. uint32_t nz;
  215. uint32_t ldy;
  216. uint32_t ldz;
  217. size_t elemsize;
  218. };
  219. 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);
  220. 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);
  221. uint32_t starpu_block_get_nx(starpu_data_handle_t handle);
  222. uint32_t starpu_block_get_ny(starpu_data_handle_t handle);
  223. uint32_t starpu_block_get_nz(starpu_data_handle_t handle);
  224. uint32_t starpu_block_get_local_ldy(starpu_data_handle_t handle);
  225. uint32_t starpu_block_get_local_ldz(starpu_data_handle_t handle);
  226. uintptr_t starpu_block_get_local_ptr(starpu_data_handle_t handle);
  227. size_t starpu_block_get_elemsize(starpu_data_handle_t handle);
  228. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  229. #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.")
  230. #define STARPU_BLOCK_GET_PTR(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ptr) ; })
  231. #define STARPU_BLOCK_GET_DEV_HANDLE(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->dev_handle) ; })
  232. #define STARPU_BLOCK_GET_OFFSET(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->offset) ; })
  233. #define STARPU_BLOCK_GET_NX(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->nx) ; })
  234. #define STARPU_BLOCK_GET_NY(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ny) ; })
  235. #define STARPU_BLOCK_GET_NZ(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->nz) ; })
  236. #define STARPU_BLOCK_GET_LDY(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ldy) ; })
  237. #define STARPU_BLOCK_GET_LDZ(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->ldz) ; })
  238. #define STARPU_BLOCK_GET_ELEMSIZE(interface) ({ STARPU_BLOCK_CHECK(interface); (((struct starpu_block_interface *)(interface))->elemsize) ; })
  239. #else
  240. #define STARPU_BLOCK_GET_PTR(interface) (((struct starpu_block_interface *)(interface))->ptr)
  241. #define STARPU_BLOCK_GET_DEV_HANDLE(interface) (((struct starpu_block_interface *)(interface))->dev_handle)
  242. #define STARPU_BLOCK_GET_OFFSET(interface) (((struct starpu_block_interface *)(interface))->offset)
  243. #define STARPU_BLOCK_GET_NX(interface) (((struct starpu_block_interface *)(interface))->nx)
  244. #define STARPU_BLOCK_GET_NY(interface) (((struct starpu_block_interface *)(interface))->ny)
  245. #define STARPU_BLOCK_GET_NZ(interface) (((struct starpu_block_interface *)(interface))->nz)
  246. #define STARPU_BLOCK_GET_LDY(interface) (((struct starpu_block_interface *)(interface))->ldy)
  247. #define STARPU_BLOCK_GET_LDZ(interface) (((struct starpu_block_interface *)(interface))->ldz)
  248. #define STARPU_BLOCK_GET_ELEMSIZE(interface) (((struct starpu_block_interface *)(interface))->elemsize)
  249. #endif
  250. extern struct starpu_data_interface_ops starpu_interface_vector_ops;
  251. struct starpu_vector_interface
  252. {
  253. enum starpu_data_interface_id id;
  254. uintptr_t ptr;
  255. uintptr_t dev_handle;
  256. size_t offset;
  257. uint32_t nx;
  258. size_t elemsize;
  259. uint32_t slice_base;
  260. };
  261. void starpu_vector_data_register(starpu_data_handle_t *handle, int home_node, uintptr_t ptr, uint32_t nx, size_t elemsize);
  262. void starpu_vector_ptr_register(starpu_data_handle_t handle, unsigned node, uintptr_t ptr, uintptr_t dev_handle, size_t offset);
  263. uint32_t starpu_vector_get_nx(starpu_data_handle_t handle);
  264. size_t starpu_vector_get_elemsize(starpu_data_handle_t handle);
  265. uintptr_t starpu_vector_get_local_ptr(starpu_data_handle_t handle);
  266. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  267. #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.")
  268. #define STARPU_VECTOR_GET_PTR(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->ptr); })
  269. #define STARPU_VECTOR_GET_DEV_HANDLE(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->dev_handle); })
  270. #define STARPU_VECTOR_GET_OFFSET(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->offset); })
  271. #define STARPU_VECTOR_GET_NX(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->nx); })
  272. #define STARPU_VECTOR_GET_ELEMSIZE(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->elemsize); })
  273. #define STARPU_VECTOR_GET_SLICE_BASE(interface) ({ STARPU_VECTOR_CHECK(interface); (((struct starpu_vector_interface *)(interface))->slice_base); })
  274. #else
  275. #define STARPU_VECTOR_GET_PTR(interface) (((struct starpu_vector_interface *)(interface))->ptr)
  276. #define STARPU_VECTOR_GET_DEV_HANDLE(interface) (((struct starpu_vector_interface *)(interface))->dev_handle)
  277. #define STARPU_VECTOR_GET_OFFSET(interface) (((struct starpu_vector_interface *)(interface))->offset)
  278. #define STARPU_VECTOR_GET_NX(interface) (((struct starpu_vector_interface *)(interface))->nx)
  279. #define STARPU_VECTOR_GET_ELEMSIZE(interface) (((struct starpu_vector_interface *)(interface))->elemsize)
  280. #define STARPU_VECTOR_GET_SLICE_BASE(interface) (((struct starpu_vector_interface *)(interface))->slice_base)
  281. #endif
  282. extern struct starpu_data_interface_ops starpu_interface_variable_ops;
  283. struct starpu_variable_interface
  284. {
  285. enum starpu_data_interface_id id;
  286. uintptr_t ptr;
  287. uintptr_t dev_handle;
  288. size_t offset;
  289. size_t elemsize;
  290. };
  291. void starpu_variable_data_register(starpu_data_handle_t *handle, int home_node, uintptr_t ptr, size_t size);
  292. void starpu_variable_ptr_register(starpu_data_handle_t handle, unsigned node, uintptr_t ptr, uintptr_t dev_handle, size_t offset);
  293. size_t starpu_variable_get_elemsize(starpu_data_handle_t handle);
  294. uintptr_t starpu_variable_get_local_ptr(starpu_data_handle_t handle);
  295. #if defined(STARPU_HAVE_STATEMENT_EXPRESSIONS) && defined(STARPU_DEBUG)
  296. #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.")
  297. #define STARPU_VARIABLE_GET_PTR(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->ptr) ; })
  298. #define STARPU_VARIABLE_GET_OFFSET(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->offset) ; })
  299. #define STARPU_VARIABLE_GET_ELEMSIZE(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->elemsize) ; })
  300. #define STARPU_VARIABLE_GET_DEV_HANDLE(interface) ({ STARPU_VARIABLE_CHECK(interface); (((struct starpu_variable_interface *)(interface))->ptr) ; })
  301. #else
  302. #define STARPU_VARIABLE_GET_PTR(interface) (((struct starpu_variable_interface *)(interface))->ptr)
  303. #define STARPU_VARIABLE_GET_OFFSET(interface) (((struct starpu_variable_interface *)(interface))->offset)
  304. #define STARPU_VARIABLE_GET_ELEMSIZE(interface) (((struct starpu_variable_interface *)(interface))->elemsize)
  305. #define STARPU_VARIABLE_GET_DEV_HANDLE(interface) (((struct starpu_variable_interface *)(interface))->ptr)
  306. #endif
  307. extern struct starpu_data_interface_ops starpu_interface_void_ops;
  308. void starpu_void_data_register(starpu_data_handle_t *handle);
  309. extern struct starpu_data_interface_ops starpu_interface_csr_ops;
  310. struct starpu_csr_interface
  311. {
  312. enum starpu_data_interface_id id;
  313. uint32_t nnz;
  314. uint32_t nrow;
  315. uintptr_t nzval;
  316. uint32_t *colind;
  317. uint32_t *rowptr;
  318. uint32_t firstentry;
  319. size_t elemsize;
  320. };
  321. 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);
  322. uint32_t starpu_csr_get_nnz(starpu_data_handle_t handle);
  323. uint32_t starpu_csr_get_nrow(starpu_data_handle_t handle);
  324. uint32_t starpu_csr_get_firstentry(starpu_data_handle_t handle);
  325. uintptr_t starpu_csr_get_local_nzval(starpu_data_handle_t handle);
  326. uint32_t *starpu_csr_get_local_colind(starpu_data_handle_t handle);
  327. uint32_t *starpu_csr_get_local_rowptr(starpu_data_handle_t handle);
  328. size_t starpu_csr_get_elemsize(starpu_data_handle_t handle);
  329. #define STARPU_CSR_GET_NNZ(interface) (((struct starpu_csr_interface *)(interface))->nnz)
  330. #define STARPU_CSR_GET_NROW(interface) (((struct starpu_csr_interface *)(interface))->nrow)
  331. #define STARPU_CSR_GET_NZVAL(interface) (((struct starpu_csr_interface *)(interface))->nzval)
  332. #define STARPU_CSR_GET_NZVAL_DEV_HANDLE(interface) \
  333. (((struct starpu_csr_interface *)(interface))->nnz)
  334. #define STARPU_CSR_GET_COLIND(interface) (((struct starpu_csr_interface *)(interface))->colind)
  335. #define STARPU_CSR_GET_COLIND_DEV_HANDLE(interface) \
  336. (((struct starpu_csr_interface *)(interface))->colind)
  337. #define STARPU_CSR_GET_ROWPTR(interface) (((struct starpu_csr_interface *)(interface))->rowptr)
  338. #define STARPU_CSR_GET_ROWPTR_DEV_HANDLE(interface) \
  339. (((struct starpu_csr_interface *)(interface))->rowptr)
  340. #define STARPU_CSR_GET_OFFSET 0
  341. #define STARPU_CSR_GET_FIRSTENTRY(interface) (((struct starpu_csr_interface *)(interface))->firstentry)
  342. #define STARPU_CSR_GET_ELEMSIZE(interface) (((struct starpu_csr_interface *)(interface))->elemsize)
  343. extern struct starpu_data_interface_ops starpu_interface_bcsr_ops;
  344. struct starpu_bcsr_interface
  345. {
  346. enum starpu_data_interface_id id;
  347. uint32_t nnz;
  348. uint32_t nrow;
  349. uintptr_t nzval;
  350. uint32_t *colind;
  351. uint32_t *rowptr;
  352. uint32_t firstentry;
  353. uint32_t r;
  354. uint32_t c;
  355. size_t elemsize;
  356. };
  357. 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);
  358. #define STARPU_BCSR_GET_NNZ(interface) (((struct starpu_bcsr_interface *)(interface))->nnz)
  359. #define STARPU_BCSR_GET_NZVAL(interface) (((struct starpu_bcsr_interface *)(interface))->nzval)
  360. #define STARPU_BCSR_GET_NZVAL_DEV_HANDLE(interface) \
  361. (((struct starpu_bcsr_interface *)(interface))->nnz)
  362. #define STARPU_BCSR_GET_COLIND(interface) (((struct starpu_bcsr_interface *)(interface))->colind)
  363. #define STARPU_BCSR_GET_COLIND_DEV_HANDLE(interface) \
  364. (((struct starpu_bcsr_interface *)(interface))->colind)
  365. #define STARPU_BCSR_GET_ROWPTR(interface) (((struct starpu_bcsr_interface *)(interface))->rowptr)
  366. #define STARPU_BCSR_GET_ROWPTR_DEV_HANDLE(interface) \
  367. (((struct starpu_bcsr_interface *)(interface))->rowptr)
  368. #define STARPU_BCSR_GET_OFFSET 0
  369. uint32_t starpu_bcsr_get_nnz(starpu_data_handle_t handle);
  370. uint32_t starpu_bcsr_get_nrow(starpu_data_handle_t handle);
  371. uint32_t starpu_bcsr_get_firstentry(starpu_data_handle_t handle);
  372. uintptr_t starpu_bcsr_get_local_nzval(starpu_data_handle_t handle);
  373. uint32_t *starpu_bcsr_get_local_colind(starpu_data_handle_t handle);
  374. uint32_t *starpu_bcsr_get_local_rowptr(starpu_data_handle_t handle);
  375. uint32_t starpu_bcsr_get_r(starpu_data_handle_t handle);
  376. uint32_t starpu_bcsr_get_c(starpu_data_handle_t handle);
  377. size_t starpu_bcsr_get_elemsize(starpu_data_handle_t handle);
  378. struct starpu_multiformat_data_interface_ops
  379. {
  380. size_t cpu_elemsize;
  381. size_t opencl_elemsize;
  382. struct starpu_codelet *cpu_to_opencl_cl;
  383. struct starpu_codelet *opencl_to_cpu_cl;
  384. size_t cuda_elemsize;
  385. struct starpu_codelet *cpu_to_cuda_cl;
  386. struct starpu_codelet *cuda_to_cpu_cl;
  387. size_t mic_elemsize;
  388. struct starpu_codelet *cpu_to_mic_cl;
  389. struct starpu_codelet *mic_to_cpu_cl;
  390. };
  391. struct starpu_multiformat_interface
  392. {
  393. enum starpu_data_interface_id id;
  394. void *cpu_ptr;
  395. void *cuda_ptr;
  396. void *opencl_ptr;
  397. void *mic_ptr;
  398. uint32_t nx;
  399. struct starpu_multiformat_data_interface_ops *ops;
  400. };
  401. 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);
  402. #define STARPU_MULTIFORMAT_GET_CPU_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->cpu_ptr)
  403. #define STARPU_MULTIFORMAT_GET_CUDA_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->cuda_ptr)
  404. #define STARPU_MULTIFORMAT_GET_OPENCL_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->opencl_ptr)
  405. #define STARPU_MULTIFORMAT_GET_MIC_PTR(interface) (((struct starpu_multiformat_interface *)(interface))->mic_ptr)
  406. #define STARPU_MULTIFORMAT_GET_NX(interface) (((struct starpu_multiformat_interface *)(interface))->nx)
  407. enum starpu_data_interface_id starpu_data_get_interface_id(starpu_data_handle_t handle);
  408. int starpu_data_pack(starpu_data_handle_t handle, void **ptr, starpu_ssize_t *count);
  409. int starpu_data_unpack(starpu_data_handle_t handle, void *ptr, size_t count);
  410. size_t starpu_data_get_size(starpu_data_handle_t handle);
  411. starpu_data_handle_t starpu_data_lookup(const void *ptr);
  412. int starpu_data_get_home_node(starpu_data_handle_t handle);
  413. #ifdef __cplusplus
  414. }
  415. #endif
  416. #endif /* __STARPU_DATA_INTERFACES_H__ */