starpu_mpi.c 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038
  1. /* StarPU --- Runtime system for heterogeneous multicore architectures.
  2. *
  3. * Copyright (C) 2009, 2010-2013 Université de Bordeaux 1
  4. * Copyright (C) 2010, 2011, 2012, 2013 Centre National de la Recherche Scientifique
  5. *
  6. * StarPU is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU Lesser General Public License as published by
  8. * the Free Software Foundation; either version 2.1 of the License, or (at
  9. * your option) any later version.
  10. *
  11. * StarPU is distributed in the hope that it will be useful, but
  12. * WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14. *
  15. * See the GNU Lesser General Public License in COPYING.LGPL for more details.
  16. */
  17. #include <stdlib.h>
  18. #include <starpu_mpi.h>
  19. #include <starpu_mpi_datatype.h>
  20. #include <starpu_mpi_private.h>
  21. #include <starpu_profiling.h>
  22. #include <starpu_mpi_stats.h>
  23. #include <starpu_mpi_insert_task.h>
  24. #include <common/config.h>
  25. #include <common/thread.h>
  26. static void _starpu_mpi_submit_new_mpi_request(void *arg);
  27. static void _starpu_mpi_handle_request_termination(struct _starpu_mpi_req *req);
  28. #ifdef STARPU_VERBOSE
  29. static char *_starpu_mpi_request_type(enum _starpu_mpi_request_type request_type);
  30. #endif
  31. static struct _starpu_mpi_req *_starpu_mpi_isend_common(starpu_data_handle_t data_handle,
  32. int dest, int mpi_tag, MPI_Comm comm,
  33. unsigned detached, void (*callback)(void *), void *arg);
  34. static struct _starpu_mpi_req *_starpu_mpi_irecv_common(starpu_data_handle_t data_handle, int source, int mpi_tag, MPI_Comm comm, unsigned detached, void (*callback)(void *), void *arg);
  35. static void _starpu_mpi_handle_detached_request(struct _starpu_mpi_req *req);
  36. /* The list of requests that have been newly submitted by the application */
  37. static struct _starpu_mpi_req_list *new_requests;
  38. /* The list of detached requests that have already been submitted to MPI */
  39. static struct _starpu_mpi_req_list *detached_requests;
  40. static starpu_pthread_mutex_t detached_requests_mutex;
  41. /* Condition to wake up progression thread */
  42. static starpu_pthread_cond_t cond_progression;
  43. /* Condition to wake up waiting for all current MPI requests to finish */
  44. static starpu_pthread_cond_t cond_finished;
  45. static starpu_pthread_mutex_t mutex;
  46. static starpu_pthread_t progress_thread;
  47. static int running = 0;
  48. /* Count requests posted by the application and not yet submitted to MPI, i.e pushed into the new_requests list */
  49. static starpu_pthread_mutex_t mutex_posted_requests;
  50. static int posted_requests = 0, newer_requests, barrier_running = 0;
  51. #define _STARPU_MPI_INC_POSTED_REQUESTS(value) { _STARPU_PTHREAD_MUTEX_LOCK(&mutex_posted_requests); posted_requests += value; _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex_posted_requests); }
  52. /********************************************************/
  53. /* */
  54. /* Send/Receive functionalities */
  55. /* */
  56. /********************************************************/
  57. static struct _starpu_mpi_req *_starpu_mpi_isend_irecv_common(starpu_data_handle_t data_handle,
  58. int srcdst, int mpi_tag, MPI_Comm comm,
  59. unsigned detached, void (*callback)(void *), void *arg,
  60. enum _starpu_mpi_request_type request_type, void (*func)(struct _starpu_mpi_req *),
  61. enum starpu_access_mode mode)
  62. {
  63. _STARPU_MPI_LOG_IN();
  64. struct _starpu_mpi_req *req = calloc(1, sizeof(struct _starpu_mpi_req));
  65. STARPU_ASSERT_MSG(req, "Invalid request");
  66. _STARPU_MPI_INC_POSTED_REQUESTS(1);
  67. /* Initialize the request structure */
  68. req->submitted = 0;
  69. req->completed = 0;
  70. _STARPU_PTHREAD_MUTEX_INIT(&req->req_mutex, NULL);
  71. _STARPU_PTHREAD_COND_INIT(&req->req_cond, NULL);
  72. req->request_type = request_type;
  73. req->user_datatype = -1;
  74. req->count = -1;
  75. req->data_handle = data_handle;
  76. req->srcdst = srcdst;
  77. req->mpi_tag = mpi_tag;
  78. req->comm = comm;
  79. req->detached = detached;
  80. req->callback = callback;
  81. req->callback_arg = arg;
  82. req->func = func;
  83. /* Asynchronously request StarPU to fetch the data in main memory: when
  84. * it is available in main memory, _starpu_mpi_submit_new_mpi_request(req) is called and
  85. * the request is actually submitted */
  86. starpu_data_acquire_cb(data_handle, mode, _starpu_mpi_submit_new_mpi_request, (void *)req);
  87. _STARPU_MPI_LOG_OUT();
  88. return req;
  89. }
  90. /********************************************************/
  91. /* */
  92. /* Send functionalities */
  93. /* */
  94. /********************************************************/
  95. static void _starpu_mpi_isend_data_func(struct _starpu_mpi_req *req)
  96. {
  97. _STARPU_MPI_LOG_IN();
  98. STARPU_ASSERT_MSG(req->ptr, "Pointer containing data to send is invalid");
  99. _STARPU_MPI_DEBUG(2, "post MPI isend request %p type %s tag %d src %d data %p ptr %p datatype '%s' count %d user_datatype %d \n", req, _starpu_mpi_request_type(req->request_type), req->mpi_tag, req->srcdst, req->data_handle, req->ptr, _starpu_mpi_datatype(req->datatype), (int)req->count, req->user_datatype);
  100. _starpu_mpi_comm_amounts_inc(req->comm, req->srcdst, req->datatype, req->count);
  101. TRACE_MPI_ISEND_SUBMIT_BEGIN(req->srcdst, req->mpi_tag, 0);
  102. req->ret = MPI_Isend(req->ptr, req->count, req->datatype, req->srcdst, req->mpi_tag, req->comm, &req->request);
  103. STARPU_ASSERT_MSG(req->ret == MPI_SUCCESS, "MPI_Isend returning %d", req->ret);
  104. TRACE_MPI_ISEND_SUBMIT_END(req->srcdst, req->mpi_tag, 0);
  105. /* somebody is perhaps waiting for the MPI request to be posted */
  106. _STARPU_PTHREAD_MUTEX_LOCK(&req->req_mutex);
  107. req->submitted = 1;
  108. _STARPU_PTHREAD_COND_BROADCAST(&req->req_cond);
  109. _STARPU_PTHREAD_MUTEX_UNLOCK(&req->req_mutex);
  110. _starpu_mpi_handle_detached_request(req);
  111. _STARPU_MPI_LOG_OUT();
  112. }
  113. static void _starpu_mpi_isend_size_func(struct _starpu_mpi_req *req)
  114. {
  115. _starpu_mpi_handle_allocate_datatype(req->data_handle, &req->datatype, &req->user_datatype);
  116. if (req->user_datatype == 0)
  117. {
  118. req->count = 1;
  119. req->ptr = starpu_handle_get_local_ptr(req->data_handle);
  120. }
  121. else
  122. {
  123. ssize_t psize = -1;
  124. int ret;
  125. // Do not pack the data, just try to find out the size
  126. starpu_handle_pack_data(req->data_handle, NULL, &psize);
  127. if (psize != -1)
  128. {
  129. // We already know the size of the data, let's send it to overlap with the packing of the data
  130. _STARPU_MPI_DEBUG(1, "Sending size %ld (%ld %s) with tag %d to node %d (first call to pack)\n", psize, sizeof(req->count), _starpu_mpi_datatype(MPI_BYTE), req->mpi_tag, req->srcdst);
  131. req->count = psize;
  132. ret = MPI_Isend(&req->count, sizeof(req->count), MPI_BYTE, req->srcdst, req->mpi_tag, req->comm, &req->size_req);
  133. STARPU_ASSERT_MSG(ret == MPI_SUCCESS, "when sending size, MPI_Isend returning %d", ret);
  134. }
  135. // Pack the data
  136. starpu_handle_pack_data(req->data_handle, &req->ptr, &req->count);
  137. if (psize == -1)
  138. {
  139. // We know the size now, let's send it
  140. _STARPU_MPI_DEBUG(1, "Sending size %ld (%ld %s) with tag %d to node %d (second call to pack)\n", req->count, sizeof(req->count), _starpu_mpi_datatype(MPI_BYTE), req->mpi_tag, req->srcdst);
  141. ret = MPI_Isend(&req->count, sizeof(req->count), MPI_BYTE, req->srcdst, req->mpi_tag, req->comm, &req->size_req);
  142. STARPU_ASSERT_MSG(ret == MPI_SUCCESS, "when sending size, MPI_Isend returning %d", ret);
  143. }
  144. else
  145. {
  146. // We check the size returned with the 2 calls to pack is the same
  147. STARPU_ASSERT_MSG(req->count == psize, "Calls to pack_data returned different sizes %ld != %ld", req->count, psize);
  148. }
  149. // We can send the data now
  150. }
  151. _starpu_mpi_isend_data_func(req);
  152. }
  153. static struct _starpu_mpi_req *_starpu_mpi_isend_common(starpu_data_handle_t data_handle,
  154. int dest, int mpi_tag, MPI_Comm comm,
  155. unsigned detached, void (*callback)(void *), void *arg)
  156. {
  157. return _starpu_mpi_isend_irecv_common(data_handle, dest, mpi_tag, comm, detached, callback, arg, SEND_REQ, _starpu_mpi_isend_size_func, STARPU_R);
  158. }
  159. int starpu_mpi_isend(starpu_data_handle_t data_handle, starpu_mpi_req *public_req, int dest, int mpi_tag, MPI_Comm comm)
  160. {
  161. _STARPU_MPI_LOG_IN();
  162. STARPU_ASSERT_MSG(public_req, "starpu_mpi_isend needs a valid starpu_mpi_req");
  163. struct _starpu_mpi_req *req;
  164. req = _starpu_mpi_isend_common(data_handle, dest, mpi_tag, comm, 0, NULL, NULL);
  165. STARPU_ASSERT_MSG(req, "Invalid return for _starpu_mpi_isend_common");
  166. *public_req = req;
  167. _STARPU_MPI_LOG_OUT();
  168. return 0;
  169. }
  170. int starpu_mpi_isend_detached(starpu_data_handle_t data_handle,
  171. int dest, int mpi_tag, MPI_Comm comm, void (*callback)(void *), void *arg)
  172. {
  173. _STARPU_MPI_LOG_IN();
  174. _starpu_mpi_isend_common(data_handle, dest, mpi_tag, comm, 1, callback, arg);
  175. _STARPU_MPI_LOG_OUT();
  176. return 0;
  177. }
  178. int starpu_mpi_send(starpu_data_handle_t data_handle, int dest, int mpi_tag, MPI_Comm comm)
  179. {
  180. starpu_mpi_req req;
  181. MPI_Status status;
  182. _STARPU_MPI_LOG_IN();
  183. memset(&status, 0, sizeof(MPI_Status));
  184. starpu_mpi_isend(data_handle, &req, dest, mpi_tag, comm);
  185. starpu_mpi_wait(&req, &status);
  186. _STARPU_MPI_LOG_OUT();
  187. return 0;
  188. }
  189. /********************************************************/
  190. /* */
  191. /* Receive functionalities */
  192. /* */
  193. /********************************************************/
  194. static void _starpu_mpi_irecv_data_func(struct _starpu_mpi_req *req)
  195. {
  196. _STARPU_MPI_LOG_IN();
  197. STARPU_ASSERT_MSG(req->ptr, "Invalid pointer to receive data");
  198. _STARPU_MPI_DEBUG(2, "post MPI irecv request %p type %s tag %d src %d data %p ptr %p datatype '%s' count %d user_datatype %d \n", req, _starpu_mpi_request_type(req->request_type), req->mpi_tag, req->srcdst, req->data_handle, req->ptr, _starpu_mpi_datatype(req->datatype), (int)req->count, req->user_datatype);
  199. TRACE_MPI_IRECV_SUBMIT_BEGIN(req->srcdst, req->mpi_tag);
  200. req->ret = MPI_Irecv(req->ptr, req->count, req->datatype, req->srcdst, req->mpi_tag, req->comm, &req->request);
  201. STARPU_ASSERT_MSG(req->ret == MPI_SUCCESS, "MPI_IRecv returning %d", req->ret);
  202. TRACE_MPI_IRECV_SUBMIT_END(req->srcdst, req->mpi_tag);
  203. /* somebody is perhaps waiting for the MPI request to be posted */
  204. _STARPU_PTHREAD_MUTEX_LOCK(&req->req_mutex);
  205. req->submitted = 1;
  206. _STARPU_PTHREAD_COND_BROADCAST(&req->req_cond);
  207. _STARPU_PTHREAD_MUTEX_UNLOCK(&req->req_mutex);
  208. _starpu_mpi_handle_detached_request(req);
  209. _STARPU_MPI_LOG_OUT();
  210. }
  211. struct _starpu_mpi_irecv_size_callback
  212. {
  213. starpu_data_handle_t handle;
  214. struct _starpu_mpi_req *req;
  215. };
  216. static void _starpu_mpi_irecv_size_callback(void *arg)
  217. {
  218. struct _starpu_mpi_irecv_size_callback *callback = (struct _starpu_mpi_irecv_size_callback *)arg;
  219. starpu_data_unregister(callback->handle);
  220. callback->req->ptr = malloc(callback->req->count);
  221. STARPU_ASSERT_MSG(callback->req->ptr, "cannot allocate message of size %ld", callback->req->count);
  222. _starpu_mpi_irecv_data_func(callback->req);
  223. free(callback);
  224. }
  225. static void _starpu_mpi_irecv_size_func(struct _starpu_mpi_req *req)
  226. {
  227. _STARPU_MPI_LOG_IN();
  228. _starpu_mpi_handle_allocate_datatype(req->data_handle, &req->datatype, &req->user_datatype);
  229. if (req->user_datatype == 0)
  230. {
  231. req->count = 1;
  232. req->ptr = starpu_handle_get_local_ptr(req->data_handle);
  233. _starpu_mpi_irecv_data_func(req);
  234. }
  235. else
  236. {
  237. struct _starpu_mpi_irecv_size_callback *callback = malloc(sizeof(struct _starpu_mpi_irecv_size_callback));
  238. callback->req = req;
  239. starpu_variable_data_register(&callback->handle, 0, (uintptr_t)&(callback->req->count), sizeof(callback->req->count));
  240. _STARPU_MPI_DEBUG(4, "Receiving size with tag %d from node %d\n", req->mpi_tag, req->srcdst);
  241. _starpu_mpi_irecv_common(callback->handle, req->srcdst, req->mpi_tag, req->comm, 1, _starpu_mpi_irecv_size_callback, callback);
  242. }
  243. }
  244. static struct _starpu_mpi_req *_starpu_mpi_irecv_common(starpu_data_handle_t data_handle, int source, int mpi_tag, MPI_Comm comm, unsigned detached, void (*callback)(void *), void *arg)
  245. {
  246. return _starpu_mpi_isend_irecv_common(data_handle, source, mpi_tag, comm, detached, callback, arg, RECV_REQ, _starpu_mpi_irecv_size_func, STARPU_W);
  247. }
  248. int starpu_mpi_irecv(starpu_data_handle_t data_handle, starpu_mpi_req *public_req, int source, int mpi_tag, MPI_Comm comm)
  249. {
  250. _STARPU_MPI_LOG_IN();
  251. STARPU_ASSERT_MSG(public_req, "starpu_mpi_irecv needs a valid starpu_mpi_req");
  252. struct _starpu_mpi_req *req;
  253. req = _starpu_mpi_irecv_common(data_handle, source, mpi_tag, comm, 0, NULL, NULL);
  254. STARPU_ASSERT_MSG(req, "Invalid return for _starpu_mpi_irecv_common");
  255. *public_req = req;
  256. _STARPU_MPI_LOG_OUT();
  257. return 0;
  258. }
  259. int starpu_mpi_irecv_detached(starpu_data_handle_t data_handle, int source, int mpi_tag, MPI_Comm comm, void (*callback)(void *), void *arg)
  260. {
  261. _STARPU_MPI_LOG_IN();
  262. _starpu_mpi_irecv_common(data_handle, source, mpi_tag, comm, 1, callback, arg);
  263. _STARPU_MPI_LOG_OUT();
  264. return 0;
  265. }
  266. int starpu_mpi_recv(starpu_data_handle_t data_handle, int source, int mpi_tag, MPI_Comm comm, MPI_Status *status)
  267. {
  268. starpu_mpi_req req;
  269. _STARPU_MPI_LOG_IN();
  270. starpu_mpi_irecv(data_handle, &req, source, mpi_tag, comm);
  271. starpu_mpi_wait(&req, status);
  272. _STARPU_MPI_LOG_OUT();
  273. return 0;
  274. }
  275. /********************************************************/
  276. /* */
  277. /* Wait functionalities */
  278. /* */
  279. /********************************************************/
  280. static void _starpu_mpi_wait_func(struct _starpu_mpi_req *waiting_req)
  281. {
  282. _STARPU_MPI_LOG_IN();
  283. /* Which is the mpi request we are waiting for ? */
  284. struct _starpu_mpi_req *req = waiting_req->other_request;
  285. TRACE_MPI_UWAIT_BEGIN(req->srcdst, req->mpi_tag);
  286. req->ret = MPI_Wait(&req->request, waiting_req->status);
  287. STARPU_ASSERT_MSG(req->ret == MPI_SUCCESS, "MPI_Wait returning %d", req->ret);
  288. TRACE_MPI_UWAIT_END(req->srcdst, req->mpi_tag);
  289. _starpu_mpi_handle_request_termination(req);
  290. _STARPU_MPI_LOG_OUT();
  291. }
  292. int starpu_mpi_wait(starpu_mpi_req *public_req, MPI_Status *status)
  293. {
  294. _STARPU_MPI_LOG_IN();
  295. int ret;
  296. struct _starpu_mpi_req *waiting_req = calloc(1, sizeof(struct _starpu_mpi_req));
  297. STARPU_ASSERT_MSG(waiting_req, "Allocation failed");
  298. struct _starpu_mpi_req *req = *public_req;
  299. _STARPU_MPI_INC_POSTED_REQUESTS(1);
  300. /* We cannot try to complete a MPI request that was not actually posted
  301. * to MPI yet. */
  302. _STARPU_PTHREAD_MUTEX_LOCK(&(req->req_mutex));
  303. while (!(req->submitted))
  304. _STARPU_PTHREAD_COND_WAIT(&(req->req_cond), &(req->req_mutex));
  305. _STARPU_PTHREAD_MUTEX_UNLOCK(&(req->req_mutex));
  306. /* Initialize the request structure */
  307. _STARPU_PTHREAD_MUTEX_INIT(&(waiting_req->req_mutex), NULL);
  308. _STARPU_PTHREAD_COND_INIT(&(waiting_req->req_cond), NULL);
  309. waiting_req->status = status;
  310. waiting_req->other_request = req;
  311. waiting_req->func = _starpu_mpi_wait_func;
  312. waiting_req->request_type = WAIT_REQ;
  313. _starpu_mpi_submit_new_mpi_request(waiting_req);
  314. /* We wait for the MPI request to finish */
  315. _STARPU_PTHREAD_MUTEX_LOCK(&req->req_mutex);
  316. while (!req->completed)
  317. _STARPU_PTHREAD_COND_WAIT(&req->req_cond, &req->req_mutex);
  318. _STARPU_PTHREAD_MUTEX_UNLOCK(&req->req_mutex);
  319. ret = req->ret;
  320. /* The internal request structure was automatically allocated */
  321. *public_req = NULL;
  322. free(req);
  323. free(waiting_req);
  324. _STARPU_MPI_LOG_OUT();
  325. return ret;
  326. }
  327. /********************************************************/
  328. /* */
  329. /* Test functionalities */
  330. /* */
  331. /********************************************************/
  332. static void _starpu_mpi_test_func(struct _starpu_mpi_req *testing_req)
  333. {
  334. _STARPU_MPI_LOG_IN();
  335. /* Which is the mpi request we are testing for ? */
  336. struct _starpu_mpi_req *req = testing_req->other_request;
  337. _STARPU_MPI_DEBUG(2, "Test request %p type %s tag %d src %d data %p ptr %p datatype '%s' count %d user_datatype %d \n",
  338. req, _starpu_mpi_request_type(req->request_type), req->mpi_tag, req->srcdst, req->data_handle, req->ptr, _starpu_mpi_datatype(req->datatype), (int)req->count, req->user_datatype);
  339. TRACE_MPI_UTESTING_BEGIN(req->srcdst, req->mpi_tag);
  340. req->ret = MPI_Test(&req->request, testing_req->flag, testing_req->status);
  341. STARPU_ASSERT_MSG(req->ret == MPI_SUCCESS, "MPI_Test returning %d", req->ret);
  342. TRACE_MPI_UTESTING_END(req->srcdst, req->mpi_tag);
  343. if (*testing_req->flag)
  344. {
  345. testing_req->ret = req->ret;
  346. _starpu_mpi_handle_request_termination(req);
  347. }
  348. _STARPU_PTHREAD_MUTEX_LOCK(&testing_req->req_mutex);
  349. testing_req->completed = 1;
  350. _STARPU_PTHREAD_COND_SIGNAL(&testing_req->req_cond);
  351. _STARPU_PTHREAD_MUTEX_UNLOCK(&testing_req->req_mutex);
  352. _STARPU_MPI_LOG_OUT();
  353. }
  354. int starpu_mpi_test(starpu_mpi_req *public_req, int *flag, MPI_Status *status)
  355. {
  356. _STARPU_MPI_LOG_IN();
  357. int ret = 0;
  358. STARPU_ASSERT_MSG(public_req, "starpu_mpi_test needs a valid starpu_mpi_req");
  359. struct _starpu_mpi_req *req = *public_req;
  360. STARPU_ASSERT_MSG(!req->detached, "MPI_Test cannot be called on a detached request");
  361. _STARPU_PTHREAD_MUTEX_LOCK(&req->req_mutex);
  362. unsigned submitted = req->submitted;
  363. _STARPU_PTHREAD_MUTEX_UNLOCK(&req->req_mutex);
  364. if (submitted)
  365. {
  366. struct _starpu_mpi_req *testing_req = calloc(1, sizeof(struct _starpu_mpi_req));
  367. STARPU_ASSERT_MSG(testing_req, "allocation failed");
  368. // memset(testing_req, 0, sizeof(struct _starpu_mpi_req));
  369. /* Initialize the request structure */
  370. _STARPU_PTHREAD_MUTEX_INIT(&(testing_req->req_mutex), NULL);
  371. _STARPU_PTHREAD_COND_INIT(&(testing_req->req_cond), NULL);
  372. testing_req->flag = flag;
  373. testing_req->status = status;
  374. testing_req->other_request = req;
  375. testing_req->func = _starpu_mpi_test_func;
  376. testing_req->completed = 0;
  377. testing_req->request_type = TEST_REQ;
  378. _STARPU_MPI_INC_POSTED_REQUESTS(1);
  379. _starpu_mpi_submit_new_mpi_request(testing_req);
  380. /* We wait for the test request to finish */
  381. _STARPU_PTHREAD_MUTEX_LOCK(&(testing_req->req_mutex));
  382. while (!(testing_req->completed))
  383. _STARPU_PTHREAD_COND_WAIT(&(testing_req->req_cond), &(testing_req->req_mutex));
  384. _STARPU_PTHREAD_MUTEX_UNLOCK(&(testing_req->req_mutex));
  385. ret = testing_req->ret;
  386. if (*(testing_req->flag))
  387. {
  388. /* The request was completed so we free the internal
  389. * request structure which was automatically allocated
  390. * */
  391. *public_req = NULL;
  392. free(req);
  393. }
  394. free(testing_req);
  395. }
  396. else
  397. {
  398. *flag = 0;
  399. }
  400. _STARPU_MPI_LOG_OUT();
  401. return ret;
  402. }
  403. /********************************************************/
  404. /* */
  405. /* Barrier functionalities */
  406. /* */
  407. /********************************************************/
  408. static void _starpu_mpi_barrier_func(struct _starpu_mpi_req *barrier_req)
  409. {
  410. _STARPU_MPI_LOG_IN();
  411. barrier_req->ret = MPI_Barrier(barrier_req->comm);
  412. STARPU_ASSERT_MSG(barrier_req->ret == MPI_SUCCESS, "MPI_Barrier returning %d", barrier_req->ret);
  413. _starpu_mpi_handle_request_termination(barrier_req);
  414. _STARPU_MPI_LOG_OUT();
  415. }
  416. int starpu_mpi_barrier(MPI_Comm comm)
  417. {
  418. _STARPU_MPI_LOG_IN();
  419. int ret;
  420. struct _starpu_mpi_req *barrier_req = calloc(1, sizeof(struct _starpu_mpi_req));
  421. STARPU_ASSERT_MSG(barrier_req, "allocation failed");
  422. /* First wait for *both* all tasks and MPI requests to finish, in case
  423. * some tasks generate MPI requests, MPI requests generate tasks, etc.
  424. */
  425. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  426. STARPU_ASSERT_MSG(!barrier_running, "Concurrent starpu_mpi_barrier is not implemented, even on different communicators");
  427. barrier_running = 1;
  428. do
  429. {
  430. while (posted_requests)
  431. /* Wait for all current MPI requests to finish */
  432. _STARPU_PTHREAD_COND_WAIT(&cond_finished, &mutex);
  433. /* No current request, clear flag */
  434. newer_requests = 0;
  435. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  436. /* Now wait for all tasks */
  437. starpu_task_wait_for_all();
  438. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  439. /* Check newer_requests again, in case some MPI requests
  440. * triggered by tasks completed and triggered tasks between
  441. * wait_for_all finished and we take the lock */
  442. } while (posted_requests || newer_requests);
  443. barrier_running = 0;
  444. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  445. /* Initialize the request structure */
  446. _STARPU_PTHREAD_MUTEX_INIT(&(barrier_req->req_mutex), NULL);
  447. _STARPU_PTHREAD_COND_INIT(&(barrier_req->req_cond), NULL);
  448. barrier_req->func = _starpu_mpi_barrier_func;
  449. barrier_req->request_type = BARRIER_REQ;
  450. barrier_req->comm = comm;
  451. _STARPU_MPI_INC_POSTED_REQUESTS(1);
  452. _starpu_mpi_submit_new_mpi_request(barrier_req);
  453. /* We wait for the MPI request to finish */
  454. _STARPU_PTHREAD_MUTEX_LOCK(&barrier_req->req_mutex);
  455. while (!barrier_req->completed)
  456. _STARPU_PTHREAD_COND_WAIT(&barrier_req->req_cond, &barrier_req->req_mutex);
  457. _STARPU_PTHREAD_MUTEX_UNLOCK(&barrier_req->req_mutex);
  458. ret = barrier_req->ret;
  459. free(barrier_req);
  460. _STARPU_MPI_LOG_OUT();
  461. return ret;
  462. }
  463. /********************************************************/
  464. /* */
  465. /* Progression */
  466. /* */
  467. /********************************************************/
  468. #ifdef STARPU_VERBOSE
  469. static char *_starpu_mpi_request_type(enum _starpu_mpi_request_type request_type)
  470. {
  471. switch (request_type)
  472. {
  473. case SEND_REQ: return "SEND_REQ";
  474. case RECV_REQ: return "RECV_REQ";
  475. case WAIT_REQ: return "WAIT_REQ";
  476. case TEST_REQ: return "TEST_REQ";
  477. case BARRIER_REQ: return "BARRIER_REQ";
  478. default: return "unknown request type";
  479. }
  480. }
  481. #endif
  482. static void _starpu_mpi_handle_request_termination(struct _starpu_mpi_req *req)
  483. {
  484. int ret;
  485. _STARPU_MPI_LOG_IN();
  486. _STARPU_MPI_DEBUG(2, "complete MPI request %p type %s tag %d src %d data %p ptr %p datatype '%s' count %d user_datatype %d \n",
  487. req, _starpu_mpi_request_type(req->request_type), req->mpi_tag, req->srcdst, req->data_handle, req->ptr, _starpu_mpi_datatype(req->datatype), (int)req->count, req->user_datatype);
  488. if (req->request_type == RECV_REQ || req->request_type == SEND_REQ)
  489. {
  490. if (req->user_datatype == 1)
  491. {
  492. if (req->request_type == SEND_REQ)
  493. {
  494. // We already know the request to send the size is completed, we just call MPI_Test to make sure that the request object is deallocated
  495. MPI_Status status;
  496. int flag;
  497. ret = MPI_Test(&req->size_req, &flag, &status);
  498. STARPU_ASSERT_MSG(ret == MPI_SUCCESS, "MPI_Test returning %d", ret);
  499. STARPU_ASSERT_MSG(flag, "MPI_Test returning flag %d", flag);
  500. }
  501. if (req->request_type == RECV_REQ)
  502. // req->ptr is freed by starpu_handle_unpack_data
  503. starpu_handle_unpack_data(req->data_handle, req->ptr, req->count);
  504. else
  505. free(req->ptr);
  506. }
  507. else
  508. {
  509. _starpu_mpi_handle_free_datatype(req->data_handle, &req->datatype);
  510. }
  511. starpu_data_release(req->data_handle);
  512. }
  513. /* Execute the specified callback, if any */
  514. if (req->callback)
  515. req->callback(req->callback_arg);
  516. /* tell anyone potentially waiting on the request that it is
  517. * terminated now */
  518. _STARPU_PTHREAD_MUTEX_LOCK(&req->req_mutex);
  519. req->completed = 1;
  520. _STARPU_PTHREAD_COND_BROADCAST(&req->req_cond);
  521. _STARPU_PTHREAD_MUTEX_UNLOCK(&req->req_mutex);
  522. _STARPU_MPI_LOG_OUT();
  523. }
  524. static void _starpu_mpi_submit_new_mpi_request(void *arg)
  525. {
  526. _STARPU_MPI_LOG_IN();
  527. struct _starpu_mpi_req *req = arg;
  528. _STARPU_MPI_INC_POSTED_REQUESTS(-1);
  529. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  530. _starpu_mpi_req_list_push_front(new_requests, req);
  531. newer_requests = 1;
  532. _STARPU_MPI_DEBUG(3, "Pushing new request %p type %s tag %d src %d data %p ptr %p datatype '%s' count %d user_datatype %d \n",
  533. req, _starpu_mpi_request_type(req->request_type), req->mpi_tag, req->srcdst, req->data_handle, req->ptr, _starpu_mpi_datatype(req->datatype), (int)req->count, req->user_datatype);
  534. _STARPU_PTHREAD_COND_BROADCAST(&cond_progression);
  535. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  536. _STARPU_MPI_LOG_OUT();
  537. }
  538. #ifdef STARPU_MPI_ACTIVITY
  539. static unsigned _starpu_mpi_progression_hook_func(void *arg __attribute__((unused)))
  540. {
  541. unsigned may_block = 1;
  542. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  543. if (!_starpu_mpi_req_list_empty(detached_requests))
  544. {
  545. _STARPU_PTHREAD_COND_SIGNAL(&cond_progression);
  546. may_block = 0;
  547. }
  548. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  549. return may_block;
  550. }
  551. #endif /* STARPU_MPI_ACTIVITY */
  552. static void _starpu_mpi_test_detached_requests(void)
  553. {
  554. _STARPU_MPI_LOG_IN();
  555. int flag;
  556. MPI_Status status;
  557. struct _starpu_mpi_req *req, *next_req;
  558. _STARPU_PTHREAD_MUTEX_LOCK(&detached_requests_mutex);
  559. for (req = _starpu_mpi_req_list_begin(detached_requests);
  560. req != _starpu_mpi_req_list_end(detached_requests);
  561. req = next_req)
  562. {
  563. next_req = _starpu_mpi_req_list_next(req);
  564. _STARPU_PTHREAD_MUTEX_UNLOCK(&detached_requests_mutex);
  565. //_STARPU_MPI_DEBUG(3, "Test detached request %p - mpitag %d - TYPE %s %d\n", &req->request, req->mpi_tag, _starpu_mpi_request_type(req->request_type), req->srcdst);
  566. req->ret = MPI_Test(&req->request, &flag, &status);
  567. STARPU_ASSERT_MSG(req->ret == MPI_SUCCESS, "MPI_Test returning %d", req->ret);
  568. if (flag)
  569. {
  570. if (req->request_type == RECV_REQ)
  571. {
  572. TRACE_MPI_IRECV_COMPLETE_BEGIN(req->srcdst, req->mpi_tag);
  573. }
  574. else if (req->request_type == SEND_REQ)
  575. {
  576. TRACE_MPI_ISEND_COMPLETE_BEGIN(req->srcdst, req->mpi_tag, 0);
  577. }
  578. _starpu_mpi_handle_request_termination(req);
  579. if (req->request_type == RECV_REQ)
  580. {
  581. TRACE_MPI_IRECV_COMPLETE_END(req->srcdst, req->mpi_tag);
  582. }
  583. else if (req->request_type == SEND_REQ)
  584. {
  585. TRACE_MPI_ISEND_COMPLETE_END(req->srcdst, req->mpi_tag, 0);
  586. }
  587. }
  588. _STARPU_PTHREAD_MUTEX_LOCK(&detached_requests_mutex);
  589. if (flag)
  590. {
  591. _starpu_mpi_req_list_erase(detached_requests, req);
  592. free(req);
  593. }
  594. }
  595. _STARPU_PTHREAD_MUTEX_UNLOCK(&detached_requests_mutex);
  596. _STARPU_MPI_LOG_OUT();
  597. }
  598. static void _starpu_mpi_handle_detached_request(struct _starpu_mpi_req *req)
  599. {
  600. if (req->detached)
  601. {
  602. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  603. _starpu_mpi_req_list_push_front(detached_requests, req);
  604. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  605. starpu_wake_all_blocked_workers();
  606. /* put the submitted request into the list of pending requests
  607. * so that it can be handled by the progression mechanisms */
  608. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  609. _STARPU_PTHREAD_COND_SIGNAL(&cond_progression);
  610. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  611. }
  612. }
  613. static void _starpu_mpi_handle_new_request(struct _starpu_mpi_req *req)
  614. {
  615. _STARPU_MPI_LOG_IN();
  616. STARPU_ASSERT_MSG(req, "Invalid request");
  617. /* submit the request to MPI */
  618. _STARPU_MPI_DEBUG(2, "Handling new request %p type %s tag %d src %d data %p ptr %p datatype '%s' count %d user_datatype %d \n",
  619. req, _starpu_mpi_request_type(req->request_type), req->mpi_tag, req->srcdst, req->data_handle, req->ptr, _starpu_mpi_datatype(req->datatype), (int)req->count, req->user_datatype);
  620. req->func(req);
  621. _STARPU_MPI_LOG_OUT();
  622. }
  623. struct _starpu_mpi_argc_argv
  624. {
  625. int initialize_mpi;
  626. int *argc;
  627. char ***argv;
  628. };
  629. static void _starpu_mpi_print_thread_level_support(int thread_level, char *msg)
  630. {
  631. switch (thread_level)
  632. {
  633. case MPI_THREAD_SERIALIZED:
  634. {
  635. _STARPU_DISP("MPI%s MPI_THREAD_SERIALIZED; Multiple threads may make MPI calls, but only one at a time.\n", msg);
  636. break;
  637. }
  638. case MPI_THREAD_FUNNELED:
  639. {
  640. _STARPU_DISP("MPI%s MPI_THREAD_FUNNELED; The application can safely make calls to StarPU-MPI functions, but should not call directly MPI communication functions.\n", msg);
  641. break;
  642. }
  643. case MPI_THREAD_SINGLE:
  644. {
  645. _STARPU_DISP("MPI%s MPI_THREAD_SINGLE; MPI does not have multi-thread support, this might cause problems. The application can make calls to StarPU-MPI functions, but not call directly MPI Communication functions.\n", msg);
  646. break;
  647. }
  648. }
  649. }
  650. static void *_starpu_mpi_progress_thread_func(void *arg)
  651. {
  652. struct _starpu_mpi_argc_argv *argc_argv = (struct _starpu_mpi_argc_argv *) arg;
  653. if (argc_argv->initialize_mpi)
  654. {
  655. int thread_support;
  656. _STARPU_DEBUG("Calling MPI_Init_thread\n");
  657. if (MPI_Init_thread(argc_argv->argc, argc_argv->argv, MPI_THREAD_SERIALIZED, &thread_support) != MPI_SUCCESS)
  658. {
  659. _STARPU_ERROR("MPI_Init_thread failed\n");
  660. }
  661. _starpu_mpi_print_thread_level_support(thread_support, "_Init_thread level =");
  662. }
  663. else
  664. {
  665. int provided;
  666. MPI_Query_thread(&provided);
  667. _starpu_mpi_print_thread_level_support(provided, " has been initialized with");
  668. }
  669. {
  670. int rank, worldsize;
  671. MPI_Comm_rank(MPI_COMM_WORLD, &rank);
  672. MPI_Comm_size(MPI_COMM_WORLD, &worldsize);
  673. TRACE_MPI_START(rank, worldsize);
  674. #ifdef STARPU_USE_FXT
  675. starpu_set_profiling_id(rank);
  676. #endif //STARPU_USE_FXT
  677. }
  678. /* notify the main thread that the progression thread is ready */
  679. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  680. running = 1;
  681. _STARPU_PTHREAD_COND_SIGNAL(&cond_progression);
  682. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  683. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  684. while (running || posted_requests || !(_starpu_mpi_req_list_empty(new_requests)) || !(_starpu_mpi_req_list_empty(detached_requests)))
  685. {
  686. /* shall we block ? */
  687. unsigned block = _starpu_mpi_req_list_empty(new_requests);
  688. #ifndef STARPU_MPI_ACTIVITY
  689. block = block && _starpu_mpi_req_list_empty(detached_requests);
  690. #endif /* STARPU_MPI_ACTIVITY */
  691. if (block)
  692. {
  693. _STARPU_MPI_DEBUG(3, "NO MORE REQUESTS TO HANDLE\n");
  694. TRACE_MPI_SLEEP_BEGIN();
  695. if (barrier_running)
  696. /* Tell mpi_barrier */
  697. _STARPU_PTHREAD_COND_SIGNAL(&cond_finished);
  698. _STARPU_PTHREAD_COND_WAIT(&cond_progression, &mutex);
  699. TRACE_MPI_SLEEP_END();
  700. }
  701. /* test whether there are some terminated "detached request" */
  702. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  703. _starpu_mpi_test_detached_requests();
  704. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  705. /* get one request */
  706. struct _starpu_mpi_req *req;
  707. while (!_starpu_mpi_req_list_empty(new_requests))
  708. {
  709. req = _starpu_mpi_req_list_pop_back(new_requests);
  710. /* handling a request is likely to block for a while
  711. * (on a sync_data_with_mem call), we want to let the
  712. * application submit requests in the meantime, so we
  713. * release the lock. */
  714. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  715. _starpu_mpi_handle_new_request(req);
  716. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  717. }
  718. }
  719. STARPU_ASSERT_MSG(_starpu_mpi_req_list_empty(detached_requests), "List of detached requests not empty");
  720. STARPU_ASSERT_MSG(_starpu_mpi_req_list_empty(new_requests), "List of new requests not empty");
  721. STARPU_ASSERT_MSG(posted_requests == 0, "Number of posted request is not zero");
  722. if (argc_argv->initialize_mpi)
  723. {
  724. _STARPU_MPI_DEBUG(3, "Calling MPI_Finalize()\n");
  725. MPI_Finalize();
  726. }
  727. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  728. free(argc_argv);
  729. return NULL;
  730. }
  731. /********************************************************/
  732. /* */
  733. /* (De)Initialization methods */
  734. /* */
  735. /********************************************************/
  736. #ifdef STARPU_MPI_ACTIVITY
  737. static int hookid = - 1;
  738. #endif /* STARPU_MPI_ACTIVITY */
  739. static void _starpu_mpi_add_sync_point_in_fxt(void)
  740. {
  741. #ifdef STARPU_USE_FXT
  742. int rank;
  743. int worldsize;
  744. int ret;
  745. MPI_Comm_rank(MPI_COMM_WORLD, &rank);
  746. MPI_Comm_size(MPI_COMM_WORLD, &worldsize);
  747. ret = MPI_Barrier(MPI_COMM_WORLD);
  748. STARPU_ASSERT_MSG(ret == MPI_SUCCESS, "MPI_Barrier returning %d", ret);
  749. /* We generate a "unique" key so that we can make sure that different
  750. * FxT traces come from the same MPI run. */
  751. int random_number;
  752. /* XXX perhaps we don't want to generate a new seed if the application
  753. * specified some reproductible behaviour ? */
  754. if (rank == 0)
  755. {
  756. srand(time(NULL));
  757. random_number = rand();
  758. }
  759. ret = MPI_Bcast(&random_number, 1, MPI_INT, 0, MPI_COMM_WORLD);
  760. STARPU_ASSERT_MSG(ret == MPI_SUCCESS, "MPI_Bcast returning %d", ret);
  761. TRACE_MPI_BARRIER(rank, worldsize, random_number);
  762. _STARPU_MPI_DEBUG(3, "unique key %x\n", random_number);
  763. #endif
  764. }
  765. static
  766. int _starpu_mpi_initialize(int *argc, char ***argv, int initialize_mpi)
  767. {
  768. _STARPU_PTHREAD_MUTEX_INIT(&mutex, NULL);
  769. _STARPU_PTHREAD_COND_INIT(&cond_progression, NULL);
  770. _STARPU_PTHREAD_COND_INIT(&cond_finished, NULL);
  771. new_requests = _starpu_mpi_req_list_new();
  772. _STARPU_PTHREAD_MUTEX_INIT(&detached_requests_mutex, NULL);
  773. detached_requests = _starpu_mpi_req_list_new();
  774. _STARPU_PTHREAD_MUTEX_INIT(&mutex_posted_requests, NULL);
  775. struct _starpu_mpi_argc_argv *argc_argv = malloc(sizeof(struct _starpu_mpi_argc_argv));
  776. argc_argv->initialize_mpi = initialize_mpi;
  777. argc_argv->argc = argc;
  778. argc_argv->argv = argv;
  779. _STARPU_PTHREAD_CREATE("MPI progress", &progress_thread, NULL, _starpu_mpi_progress_thread_func, argc_argv);
  780. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  781. while (!running)
  782. _STARPU_PTHREAD_COND_WAIT(&cond_progression, &mutex);
  783. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  784. #ifdef STARPU_MPI_ACTIVITY
  785. hookid = starpu_progression_hook_register(progression_hook_func, NULL);
  786. STARPU_ASSERT_MSG(hookid >= 0, "starpu_progression_hook_register failed");
  787. #endif /* STARPU_MPI_ACTIVITY */
  788. _starpu_mpi_add_sync_point_in_fxt();
  789. _starpu_mpi_comm_amounts_init(MPI_COMM_WORLD);
  790. _starpu_mpi_cache_init(MPI_COMM_WORLD);
  791. return 0;
  792. }
  793. int starpu_mpi_init(int *argc, char ***argv, int initialize_mpi)
  794. {
  795. return _starpu_mpi_initialize(argc, argv, initialize_mpi);
  796. }
  797. int starpu_mpi_initialize(void)
  798. {
  799. return _starpu_mpi_initialize(NULL, NULL, 0);
  800. }
  801. int starpu_mpi_initialize_extended(int *rank, int *world_size)
  802. {
  803. int ret;
  804. ret = _starpu_mpi_initialize(NULL, NULL, 1);
  805. if (ret == 0)
  806. {
  807. _STARPU_DEBUG("Calling MPI_Comm_rank\n");
  808. MPI_Comm_rank(MPI_COMM_WORLD, rank);
  809. MPI_Comm_size(MPI_COMM_WORLD, world_size);
  810. }
  811. return ret;
  812. }
  813. int starpu_mpi_shutdown(void)
  814. {
  815. void *value;
  816. int rank, world_size;
  817. /* We need to get the rank before calling MPI_Finalize to pass to _starpu_mpi_comm_amounts_display() */
  818. MPI_Comm_rank(MPI_COMM_WORLD, &rank);
  819. MPI_Comm_size(MPI_COMM_WORLD, &world_size);
  820. /* kill the progression thread */
  821. _STARPU_PTHREAD_MUTEX_LOCK(&mutex);
  822. running = 0;
  823. _STARPU_PTHREAD_COND_BROADCAST(&cond_progression);
  824. _STARPU_PTHREAD_MUTEX_UNLOCK(&mutex);
  825. starpu_pthread_join(progress_thread, &value);
  826. #ifdef STARPU_MPI_ACTIVITY
  827. starpu_progression_hook_deregister(hookid);
  828. #endif /* STARPU_MPI_ACTIVITY */
  829. TRACE_MPI_STOP(rank, world_size);
  830. /* free the request queues */
  831. _starpu_mpi_req_list_delete(detached_requests);
  832. _starpu_mpi_req_list_delete(new_requests);
  833. _starpu_mpi_comm_amounts_display(rank);
  834. _starpu_mpi_comm_amounts_free();
  835. _starpu_mpi_cache_free(world_size);
  836. return 0;
  837. }