vector_scal_c.c 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  1. /* StarPU --- Runtime system for heterogeneous multicore architectures.
  2. *
  3. * Copyright (C) 2011-2013 Inria
  4. * Copyright (C) 2010-2013,2015,2017 CNRS
  5. * Copyright (C) 2011,2013,2014 Université de Bordeaux
  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. /*
  19. * This example demonstrates how to use StarPU to scale an array by a factor.
  20. * It shows how to manipulate data with StarPU's data management library.
  21. * 1- how to declare a piece of data to StarPU (starpu_vector_data_register)
  22. * 2- how to describe which data are accessed by a task (task->handles[0])
  23. * 3- how a kernel can manipulate the data (buffers[0].vector.ptr)
  24. *
  25. * This is a variant of vector_scal.c which shows it can be integrated with fortran.
  26. */
  27. #include <starpu.h>
  28. #include <stdio.h>
  29. extern void scal_cpu_func(void *buffers[], void *_args);
  30. extern void scal_cuda_func(void *buffers[], void *_args);
  31. static struct starpu_perfmodel vector_scal_model =
  32. {
  33. .type = STARPU_HISTORY_BASED,
  34. .symbol = "vector_scal_model"
  35. };
  36. static struct starpu_codelet cl =
  37. {
  38. .modes = { STARPU_RW },
  39. /* CPU implementation of the codelet */
  40. .cpu_funcs = {scal_cpu_func},
  41. .cpu_funcs_name = {"scal_cpu_func"},
  42. #ifdef STARPU_USE_CUDA
  43. /* CUDA implementation of the codelet */
  44. .cuda_funcs = {scal_cuda_func},
  45. .cuda_flags = {STARPU_CUDA_ASYNC},
  46. #endif
  47. .nbuffers = 1,
  48. .model = &vector_scal_model
  49. };
  50. int compute_(int *F_NX, float *vector)
  51. {
  52. int NX = *F_NX;
  53. int ret;
  54. /* Initialize StarPU with default configuration */
  55. ret = starpu_init(NULL);
  56. if (ret == -ENODEV) return 77;
  57. STARPU_CHECK_RETURN_VALUE(ret, "starpu_init");
  58. /* Tell StaPU to associate the "vector" vector with the "vector_handle"
  59. * identifier. When a task needs to access a piece of data, it should
  60. * refer to the handle that is associated to it.
  61. * In the case of the "vector" data interface:
  62. * - the first argument of the registration method is a pointer to the
  63. * handle that should describe the data
  64. * - the second argument is the memory node where the data (ie. "vector")
  65. * resides initially: STARPU_MAIN_RAM stands for an address in main memory, as
  66. * opposed to an adress on a GPU for instance.
  67. * - the third argument is the adress of the vector in RAM
  68. * - the fourth argument is the number of elements in the vector
  69. * - the fifth argument is the size of each element.
  70. */
  71. starpu_data_handle_t vector_handle;
  72. starpu_vector_data_register(&vector_handle, STARPU_MAIN_RAM, (uintptr_t)vector, NX, sizeof(vector[0]));
  73. float factor = 3.14;
  74. /* create a synchronous task: any call to starpu_task_submit will block
  75. * until it is terminated */
  76. struct starpu_task *task = starpu_task_create();
  77. task->synchronous = 1;
  78. task->cl = &cl;
  79. /* the codelet manipulates one buffer in RW mode */
  80. task->handles[0] = vector_handle;
  81. /* an argument is passed to the codelet, beware that this is a
  82. * READ-ONLY buffer and that the codelet may be given a pointer to a
  83. * COPY of the argument */
  84. task->cl_arg = &factor;
  85. task->cl_arg_size = sizeof(factor);
  86. /* execute the task on any eligible computational ressource */
  87. ret = starpu_task_submit(task);
  88. if (ret != -ENODEV) STARPU_CHECK_RETURN_VALUE(ret, "starpu_task_submit");
  89. /* StarPU does not need to manipulate the array anymore so we can stop
  90. * monitoring it */
  91. starpu_data_unregister(vector_handle);
  92. /* terminate StarPU, no task can be submitted after */
  93. starpu_shutdown();
  94. return ret;
  95. }