ChangeLog 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500
  1. # StarPU --- Runtime system for heterogeneous multicore architectures.
  2. #
  3. # Copyright (C) 2009-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. StarPU 1.2.0 (svn revision xxxx)
  17. ==============================================
  18. New features:
  19. * Xeon Phi support
  20. * SCC support
  21. * New function starpu_sched_ctx_exec_parallel_code to execute a
  22. parallel code on the workers of the given scheduler context
  23. * MPI:
  24. - New internal communication system : a unique tag called
  25. is now used for all communications, and a system
  26. of hashmaps on each node which stores pending receives has been
  27. implemented. Every message is now coupled with an envelope, sent
  28. before the corresponding data, which allows the receiver to
  29. allocate data correctly, and to submit the matching receive of
  30. the envelope.
  31. * New STARPU_COMMUTE flag which can be passed along STARPU_W or STARPU_RW to
  32. let starpu commute write accesses.
  33. * Out-of-core support, through registration of disk areas as additional memory
  34. nodes.
  35. * StarPU-MPI: new function
  36. starpu_mpi_irecv_detached_sequential_consistency which allows to
  37. enable or disable the sequential consistency for the given data
  38. handle (sequential consistency will be enabled or disabled based
  39. on the value of the function parameter and the value of the
  40. sequential consistency defined for the given data)
  41. * Performance models files are now stored in a directory whose name
  42. include the version of the performance model format. The version
  43. number is also written in the file itself.
  44. When updating the format, the internal variable
  45. _STARPU_PERFMODEL_VERSION should be updated. It is then possible
  46. to switch easily between differents versions of StarPU having
  47. different performance model formats.
  48. * Tasks can now define a optional prologue callback which is executed
  49. on the host when the task becomes ready for execution, before getting
  50. scheduled.
  51. Small features:
  52. * Add cl_arg_free field to enable automatic free(cl_arg) on task
  53. destroy.
  54. * New functions starpu_data_acquire_cb_sequential_consistency() and
  55. starpu_data_acquire_on_node_cb_sequential_consistency() which allows
  56. to enable or disable sequential consistency
  57. * New configure option --enable-fxt-lock which enables additional
  58. trace events focused on locks behaviour during the execution
  59. * New function starpu_perfmodel_directory() to print directory
  60. storing performance models. Available through the new option -d of
  61. the tool starpu_perfmodel_display
  62. * New batch files to execute StarPU applications under Microsoft
  63. Visual Studio (They are installed in path_to_starpu/bin/mvsc)/
  64. Changes:
  65. * Fix of the livelock issue discovered while executing applications
  66. on a CPU+GPU cluster of machines by adding a maximum trylock
  67. threshold before a blocking lock.
  68. * Data interfaces (variable, vector, matrix and block) now define
  69. pack und unpack functions
  70. * Fix for properly dealing with NAN on windows systems
  71. StarPU 1.1.0 (svn revision xxxx)
  72. ==============================================
  73. New features:
  74. * OpenGL interoperability support.
  75. * Capability to store compiled OpenCL kernels on the file system
  76. * Capability to load compiled OpenCL kernels
  77. * Performance models measurements can now be provided explicitly by
  78. applications.
  79. * Capability to emit communication statistics when running MPI code
  80. * Add starpu_unregister_submit, starpu_data_acquire_on_node and
  81. starpu_data_invalidate_submit
  82. * New functionnality to wrapper starpu_insert_task to pass a array of
  83. data_handles via the parameter STARPU_DATA_ARRAY
  84. * Enable GPU-GPU direct transfers.
  85. * GCC plug-in
  86. - Add `registered' attribute
  87. - A new pass was added that warns about the use of possibly
  88. unregistered memory buffers.
  89. * SOCL
  90. - Manual mapping of commands on specific devices is now
  91. possible
  92. - SOCL does not require StarPU CPU tasks anymore. CPU workers
  93. are automatically disabled to enhance performance of OpenCL
  94. CPU devices
  95. * New interface: COO matrix.
  96. * Data interfaces: The pack operation of user-defined data interface
  97. defines a new parameter count which should be set to the size of
  98. the buffer created by the packing of the data.
  99. * MPI:
  100. - Communication statistics for MPI can only be enabled at
  101. execution time by defining the environment variable
  102. STARPU_COMM_STATS
  103. - Communication cache mechanism is enabled by default, and can
  104. only be disabled at execution time by setting the
  105. environment variable STARPU_MPI_CACHE to 0.
  106. - Initialisation functions starpu_mpi_initialize_extended()
  107. and starpu_mpi_initialize() have been made deprecated. One
  108. should now use starpu_mpi_init(int *, char ***, int). The
  109. last parameter indicates if MPI should be initialised.
  110. - Collective detached operations have new parameters, a
  111. callback function and a argument. This is to be consistent
  112. with the detached point-to-point communications.
  113. - When exchanging user-defined data interfaces, the size of
  114. the data is the size returned by the pack operation, i.e
  115. data with dynamic size can now be exchanged with StarPU-MPI.
  116. * Add experimental simgrid support, to simulate execution with various
  117. number of CPUs, GPUs, amount of memory, etc.
  118. * Add support for OpenCL simulators (which provide simulated execution time)
  119. * Add support for Temanejo, a task graph debugger
  120. * Theoretical bound lp output now includes data transfer time.
  121. * Update OpenCL driver to only enable CPU devices (the environment
  122. variable STARPU_OPENCL_ONLY_ON_CPUS must be set to a positive
  123. value when executing an application)
  124. * Add Scheduling contexts to separate computation resources
  125. - Scheduling policies take into account the set of resources corresponding
  126. to the context it belongs to
  127. - Add support to dynamically change scheduling contexts
  128. (Create and Delete a context, Add Workers to a context, Remove workers from a context)
  129. - Add support to indicate to which contexts the tasks are submitted
  130. * Add the Hypervisor to manage the Scheduling Contexts automatically
  131. - The Contexts can be registered to the Hypervisor
  132. - Only the registered contexts are managed by the Hypervisor
  133. - The Hypervisor can detect the initial distribution of resources of
  134. a context and constructs it consequently (the cost of execution is required)
  135. - Several policies can adapt dynamically the distribution of resources
  136. in contexts if the initial one was not appropriate
  137. - Add a platform to implement new policies of redistribution
  138. of resources
  139. * Implement a memory manager which checks the global amount of
  140. memory available on devices, and checks there is enough memory
  141. before doing an allocation on the device.
  142. * Discard environment variable STARPU_LIMIT_GPU_MEM and define
  143. instead STARPU_LIMIT_CUDA_MEM and STARPU_LIMIT_OPENCL_MEM
  144. * Introduce new variables STARPU_LIMIT_CUDA_devid_MEM and
  145. STARPU_LIMIT_OPENCL_devid_MEM to limit memory per specific device
  146. * Introduce new variable STARPU_LIMIT_CPU_MEM to limit memory for
  147. the CPU devices
  148. * New function starpu_malloc_flags to define a memory allocation with
  149. constraints based on the following values:
  150. - STARPU_MALLOC_PINNED specifies memory should be pinned
  151. - STARPU_MALLOC_COUNT specifies the memory allocation should be in
  152. the limits defined by the environment variables STARPU_LIMIT_xxx
  153. (see above). When no memory is left, starpu_malloc_flag tries
  154. to reclaim memory from StarPU and returns -ENOMEM on failure.
  155. * starpu_malloc calls starpu_malloc_flags with a value of flag set
  156. to STARPU_MALLOC_PINNED
  157. * Define new function starpu_free_flags similarly to starpu_malloc_flags
  158. * Define new public API starpu_pthread which is similar to the
  159. pthread API. It is provided with 2 implementations: a pthread one
  160. and a Simgrid one. Applications using StarPU and wishing to use
  161. the Simgrid StarPU features should use it.
  162. * Allow to have a dynamically allocated number of buffers per task,
  163. and so overwrite the value defined --enable-maxbuffers=XXX
  164. Small features:
  165. * Add starpu_worker_get_by_type and starpu_worker_get_by_devid
  166. * Add starpu_fxt_stop_profiling/starpu_fxt_start_profiling which permits to
  167. pause trace recording.
  168. * Add trace_buffer_size configuration field to permit to specify the tracing
  169. buffer size.
  170. * Add starpu_codelet_profile and starpu_codelet_histo_profile, tools which draw
  171. the profile of a codelet.
  172. * File STARPU-REVISION --- containing the SVN revision number from which
  173. StarPU was compiled --- is installed in the share/doc/starpu directory
  174. * starpu_perfmodel_plot can now directly draw GFlops curves.
  175. * New configure option --enable-mpi-progression-hook to enable the
  176. activity polling method for StarPU-MPI.
  177. * Permit to disable sequential consistency for a given task.
  178. * New macro STARPU_RELEASE_VERSION
  179. * New function starpu_get_version() to return as 3 integers the
  180. release version of StarPU.
  181. * Enable by default data allocation cache
  182. Changes:
  183. * Rename all filter functions to follow the pattern
  184. starpu_DATATYPE_filter_FILTERTYPE. The script
  185. tools/dev/rename_filter.sh is provided to update your existing
  186. applications to use new filters function names.
  187. * Renaming of diverse functions and datatypes. The script
  188. tools/dev/rename.sh is provided to update your existing
  189. applications to use the new names. It is also possible to compile
  190. with the pkg-config package starpu-1.0 to keep using the old
  191. names. It is however recommended to update your code and to use
  192. the package starpu-1.1.
  193. * Fix the block filter functions.
  194. * Fix StarPU-MPI on Darwin.
  195. * The FxT code can now be used on systems other than Linux.
  196. * Keep only one hashtable implementation common/uthash.h
  197. * The cache of starpu_mpi_insert_task is fixed and thus now enabled by
  198. default.
  199. * Improve starpu_machine_display output.
  200. * Standardize objects name in the performance model API
  201. * SOCL
  202. - Virtual SOCL device has been removed
  203. - Automatic scheduling still available with command queues not
  204. assigned to any device
  205. - Remove modified OpenCL headers. ICD is now the only supported
  206. way to use SOCL.
  207. - SOCL test suite is only run when environment variable
  208. SOCL_OCL_LIB_OPENCL is defined. It should contain the location
  209. of the libOpenCL.so file of the OCL ICD implementation.
  210. * Fix main memory leak on multiple unregister/re-register.
  211. * Improve hwloc detection by configure
  212. * Cell:
  213. - It is no longer possible to enable the cell support via the
  214. gordon driver
  215. - Data interfaces no longer define functions to copy to and from
  216. SPU devices
  217. - Codelet no longer define pointer for Gordon implementations
  218. - Gordon workers are no longer enabled
  219. - Gordon performance models are no longer enabled
  220. * Fix data transfer arrows in paje traces
  221. * The "heft" scheduler no longer exists. Users should now pick "dmda"
  222. instead.
  223. * StarPU can now use poti to generate paje traces.
  224. * Rename scheduling policy "parallel greedy" to "parallel eager"
  225. * starpu_scheduler.h is no longer automatically included by
  226. starpu.h, it has to be manually included when needed
  227. * New batch files to run StarPU applications with Microsoft Visual C
  228. * Add examples/release/Makefile to test StarPU examples against an
  229. installed version of StarPU. That can also be used to test
  230. examples using a previous API.
  231. * Tutorial is installed in ${docdir}/tutorial
  232. * Schedulers eager_central_policy, dm and dmda no longer erroneously respect
  233. priorities. dmdas has to be used to respect priorities.
  234. * Documentation is now generated through doxygen.
  235. Small changes:
  236. * STARPU_NCPU should now be used instead of STARPU_NCPUS. STARPU_NCPUS is
  237. still available for compatibility reasons.
  238. * include/starpu.h includes all include/starpu_*.h files, applications
  239. therefore only need to have #include <starpu.h>
  240. * Active task wait is now included in blocked time.
  241. * Fix GCC plugin linking issues starting with GCC 4.7.
  242. * Fix forcing calibration of never-calibrated archs.
  243. * CUDA applications are no longer compiled with the "-arch sm_13"
  244. option. It is specifically added to applications which need it.
  245. * Explicitly name the non-sleeping-non-running time "Overhead", and use
  246. another color in vite traces.
  247. * Use C99 variadic macro support, not GNU.
  248. * Fix performance regression: dmda queues were inadvertently made
  249. LIFOs in r9611.
  250. StarPU 1.0.3 (svn revision 7379)
  251. ==============================================
  252. Changes:
  253. * Several bug fixes in the build system
  254. * Bug fixes in source code for non-Linux systems
  255. * Fix generating FXT traces bigger than 64MiB.
  256. * Improve ENODEV error detections in StarPU FFT
  257. StarPU 1.0.2 (svn revision xxx)
  258. ==============================================
  259. Changes:
  260. * Add starpu_block_shadow_filter_func_vector and an example.
  261. * Add tag dependency in trace-generated DAG.
  262. * Fix CPU binding for optimized CPU-GPU transfers.
  263. * Fix parallel tasks CPU binding and combined worker generation.
  264. * Fix generating FXT traces bigger than 64MiB.
  265. StarPU 1.0.1 (svn revision 6659)
  266. ==============================================
  267. Changes:
  268. * hwloc support. Warn users when hwloc is not found on the system and
  269. produce error when not explicitely disabled.
  270. * Several bug fixes
  271. * GCC plug-in
  272. - Add `#pragma starpu release'
  273. - Fix bug when using `acquire' pragma with function parameters
  274. - Slightly improve test suite coverage
  275. - Relax the GCC version check
  276. * Update SOCL to use new API
  277. * Documentation improvement.
  278. StarPU 1.0.0 (svn revision 6306)
  279. ==============================================
  280. The extensions-again release
  281. New features:
  282. * Add SOCL, an OpenCL interface on top of StarPU.
  283. * Add a gcc plugin to extend the C interface with pragmas which allows to
  284. easily define codelets and issue tasks.
  285. * Add reduction mode to starpu_mpi_insert_task.
  286. * A new multi-format interface permits to use different binary formats
  287. on CPUs & GPUs, the conversion functions being provided by the
  288. application and called by StarPU as needed (and as less as
  289. possible).
  290. * Deprecate cost_model, and introduce cost_function, which is provided
  291. with the whole task structure, the target arch and implementation
  292. number.
  293. * Permit the application to provide its own size base for performance
  294. models.
  295. * Applications can provide several implementations of a codelet for the
  296. same architecture.
  297. * Add a StarPU-Top feedback and steering interface.
  298. * Permit to specify MPI tags for more efficient starpu_mpi_insert_task
  299. Changes:
  300. * Fix several memory leaks and race conditions
  301. * Make environment variables take precedence over the configuration
  302. passed to starpu_init()
  303. * Libtool interface versioning has been included in libraries names
  304. (libstarpu-1.0.so, libstarpumpi-1.0.so,
  305. libstarpufft-1.0.so, libsocl-1.0.so)
  306. * Install headers under $includedir/starpu/1.0.
  307. * Make where field for struct starpu_codelet optional. When unset, its
  308. value will be automatically set based on the availability of the
  309. different XXX_funcs fields of the codelet.
  310. * Define access modes for data handles into starpu_codelet and no longer
  311. in starpu_task. Hence mark (struct starpu_task).buffers as
  312. deprecated, and add (struct starpu_task).handles and (struct
  313. starpu_codelet).modes
  314. * Fields xxx_func of struct starpu_codelet are made deprecated. One
  315. should use fields xxx_funcs instead.
  316. * Some types were renamed for consistency. when using pkg-config libstarpu,
  317. starpu_deprecated_api.h is automatically included (after starpu.h) to
  318. keep compatibility with existing software. Other changes are mentioned
  319. below, compatibility is also preserved for them.
  320. To port code to use new names (this is not mandatory), the
  321. tools/dev/rename.sh script can be used, and pkg-config starpu-1.0 should
  322. be used.
  323. * The communication cost in the heft and dmda scheduling strategies now
  324. take into account the contention brought by the number of GPUs. This
  325. changes the meaning of the beta factor, whose default 1.0 value should
  326. now be good enough in most case.
  327. Small features:
  328. * Allow users to disable asynchronous data transfers between CPUs and
  329. GPUs.
  330. * Update OpenCL driver to enable CPU devices (the environment variable
  331. STARPU_OPENCL_ON_CPUS must be set to a positive value when
  332. executing an application)
  333. * struct starpu_data_interface_ops --- operations on a data
  334. interface --- define a new function pointer allocate_new_data
  335. which creates a new data interface of the given type based on
  336. an existing handle
  337. * Add a field named magic to struct starpu_task which is set when
  338. initialising the task. starpu_task_submit will fail if the
  339. field does not have the right value. This will hence avoid
  340. submitting tasks which have not been properly initialised.
  341. * Add a hook function pre_exec_hook in struct starpu_sched_policy.
  342. The function is meant to be called in drivers. Schedulers
  343. can use it to be notified when a task is about being computed.
  344. * Add codelet execution time statistics plot.
  345. * Add bus speed in starpu_machine_display.
  346. * Add a STARPU_DATA_ACQUIRE_CB which permits to inline the code to be
  347. done.
  348. * Add gdb functions.
  349. * Add complex support to LU example.
  350. * Permit to use the same data several times in write mode in the
  351. parameters of the same task.
  352. Small changes:
  353. * Increase default value for STARPU_MAXCPUS -- Maximum number of
  354. CPUs supported -- to 64.
  355. * Add man pages for some of the tools
  356. * Add C++ application example in examples/cpp/
  357. * Add an OpenMP fork-join example.
  358. * Documentation improvement.
  359. StarPU 0.9 (svn revision 3721)
  360. ==============================================
  361. The extensions release
  362. * Provide the STARPU_REDUX data access mode
  363. * Externalize the scheduler API.
  364. * Add theoretical bound computation
  365. * Add the void interface
  366. * Add power consumption optimization
  367. * Add parallel task support
  368. * Add starpu_mpi_insert_task
  369. * Add profiling information interface.
  370. * Add STARPU_LIMIT_GPU_MEM environment variable.
  371. * OpenCL fixes
  372. * MPI fixes
  373. * Improve optimization documentation
  374. * Upgrade to hwloc 1.1 interface
  375. * Add fortran example
  376. * Add mandelbrot OpenCL example
  377. * Add cg example
  378. * Add stencil MPI example
  379. * Initial support for CUDA4
  380. StarPU 0.4 (svn revision 2535)
  381. ==============================================
  382. The API strengthening release
  383. * Major API improvements
  384. - Provide the STARPU_SCRATCH data access mode
  385. - Rework data filter interface
  386. - Rework data interface structure
  387. - A script that automatically renames old functions to accomodate with the new
  388. API is available from https://scm.gforge.inria.fr/svn/starpu/scripts/renaming
  389. (login: anonsvn, password: anonsvn)
  390. * Implement dependencies between task directly (eg. without tags)
  391. * Implicit data-driven task dependencies simplifies the design of
  392. data-parallel algorithms
  393. * Add dynamic profiling capabilities
  394. - Provide per-task feedback
  395. - Provide per-worker feedback
  396. - Provide feedback about memory transfers
  397. * Provide a library to help accelerating MPI applications
  398. * Improve data transfers overhead prediction
  399. - Transparently benchmark buses to generate performance models
  400. - Bind accelerator-controlling threads with respect to NUMA locality
  401. * Improve StarPU's portability
  402. - Add OpenCL support
  403. - Add support for Windows
  404. StarPU 0.2.901 aka 0.3-rc1 (svn revision 1236)
  405. ==============================================
  406. The asynchronous heterogeneous multi-accelerator release
  407. * Many API changes and code cleanups
  408. - Implement starpu_worker_get_id
  409. - Implement starpu_worker_get_name
  410. - Implement starpu_worker_get_type
  411. - Implement starpu_worker_get_count
  412. - Implement starpu_display_codelet_stats
  413. - Implement starpu_data_prefetch_on_node
  414. - Expose the starpu_data_set_wt_mask function
  415. * Support nvidia (heterogeneous) multi-GPU
  416. * Add the data request mechanism
  417. - All data transfers use data requests now
  418. - Implement asynchronous data transfers
  419. - Implement prefetch mechanism
  420. - Chain data requests to support GPU->RAM->GPU transfers
  421. * Make it possible to bypass the scheduler and to assign a task to a specific
  422. worker
  423. * Support restartable tasks to reinstanciate dependencies task graphs
  424. * Improve performance prediction
  425. - Model data transfer overhead
  426. - One model is created for each accelerator
  427. * Support for CUDA's driver API is deprecated
  428. * The STARPU_WORKERS_CUDAID and STARPU_WORKERS_CPUID env. variables make it possible to
  429. specify where to bind the workers
  430. * Use the hwloc library to detect the actual number of cores
  431. StarPU 0.2.0 (svn revision 1013)
  432. ==============================================
  433. The Stabilizing-the-Basics release
  434. * Various API cleanups
  435. * Mac OS X is supported now
  436. * Add dynamic code loading facilities onto Cell's SPUs
  437. * Improve performance analysis/feedback tools
  438. * Application can interact with StarPU tasks
  439. - The application may access/modify data managed by the DSM
  440. - The application may wait for the termination of a (set of) task(s)
  441. * An initial documentation is added
  442. * More examples are supplied
  443. StarPU 0.1.0 (svn revision 794)
  444. ==============================================
  445. First release.
  446. Status:
  447. * Only supports Linux platforms yet
  448. * Supported architectures
  449. - multicore CPUs
  450. - NVIDIA GPUs (with CUDA 2.x)
  451. - experimental Cell/BE support
  452. Changes:
  453. * Scheduling facilities
  454. - run-time selection of the scheduling policy
  455. - basic auto-tuning facilities
  456. * Software-based DSM
  457. - transparent data coherency management
  458. - High-level expressive interface
  459. # Local Variables:
  460. # mode: text
  461. # coding: utf-8
  462. # ispell-local-dictionary: "american"
  463. # End: