starpu.texi 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286
  1. \input texinfo @c -*-texinfo-*-
  2. @c %**start of header
  3. @setfilename starpu.info
  4. @settitle StarPU Handbook
  5. @c %**end of header
  6. @include chapters/version.texi
  7. @copying
  8. Copyright @copyright{} 2009--2011 Universit@'e de Bordeaux 1
  9. @noindent
  10. Copyright @copyright{} 2010, 2011, 2012 Centre National de la Recherche Scientifique
  11. @noindent
  12. Copyright @copyright{} 2011, 2012 Institut National de Recherche en Informatique et Automatique
  13. @quotation
  14. Permission is granted to copy, distribute and/or modify this document
  15. under the terms of the GNU Free Documentation License, Version 1.3
  16. or any later version published by the Free Software Foundation;
  17. with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
  18. Texts. A copy of the license is included in the section entitled ``GNU
  19. Free Documentation License''.
  20. @end quotation
  21. @end copying
  22. @setchapternewpage odd
  23. @dircategory Development
  24. @direntry
  25. * StarPU: (starpu). StarPU Handbook
  26. @end direntry
  27. @titlepage
  28. @title StarPU Handbook
  29. @subtitle for StarPU @value{VERSION}
  30. @page
  31. @vskip 0pt plus 1fill
  32. @insertcopying
  33. @end titlepage
  34. @c @summarycontents
  35. @contents
  36. @page
  37. @ifnottex
  38. @node Top
  39. @top StarPU Handbook
  40. @end ifnottex
  41. This manual documents the usage of StarPU version @value{VERSION}. It
  42. was last updated on @value{UPDATED}.
  43. @ifnottex
  44. @insertcopying
  45. @end ifnottex
  46. @comment
  47. @comment When you add a new menu item, please keep the right hand
  48. @comment aligned to the same column. Do not use tabs. This provides
  49. @comment better formatting.
  50. @comment
  51. @menu
  52. <<<<<<< .working
  53. * Introduction:: Getting started
  54. * Installing StarPU:: How to configure, build and install StarPU
  55. * Using StarPU:: How to run StarPU application
  56. * Basic Examples:: Basic examples of the use of StarPU
  57. * Advanced Examples:: Advanced examples of the use of StarPU
  58. * Performance optimization:: How to optimize performance with StarPU
  59. * Performance feedback:: Performance debugging tools
  60. * Tips and Tricks:: Tips and tricks to know about
  61. * StarPU MPI support:: How to combine StarPU with MPI
  62. * StarPU FFT support:: How to perform FFT computations with StarPU
  63. * C Extensions:: Easier StarPU programming with GCC
  64. * SOCL OpenCL Extensions:: How to use OpenCL on top of StarPU
  65. * Scheduling Context Hypervisor:: How to use Scheduling Context Hypervisor with StarPU
  66. * StarPU Basic API:: The Basic API to use StarPU
  67. * StarPU Advanced API:: Advanced use of StarPU
  68. * Configuring StarPU:: How to configure StarPU
  69. =======
  70. * Introduction:: Getting started
  71. * Installing StarPU:: How to configure, build and install StarPU
  72. * Using StarPU:: How to run StarPU application
  73. * Basic Examples:: Basic examples of the use of StarPU
  74. * Advanced Examples:: Advanced examples of the use of StarPU
  75. * Benchmarks:: Benchmarks worth running
  76. * Performance optimization:: How to optimize performance with StarPU
  77. * Performance feedback:: Performance debugging tools
  78. * Tips and Tricks:: Tips and tricks to know about
  79. * StarPU MPI support:: How to combine StarPU with MPI
  80. * StarPU FFT support:: How to perform FFT computations with StarPU
  81. * C Extensions:: Easier StarPU programming with GCC
  82. * SOCL OpenCL Extensions:: How to use OpenCL on top of StarPU
  83. * StarPU Basic API:: The Basic API to use StarPU
  84. * StarPU Advanced API:: Advanced use of StarPU
  85. * Configuring StarPU:: How to configure StarPU
  86. >>>>>>> .merge-right.r7640
  87. * Full source code for the 'Scaling a Vector' example::
  88. * GNU Free Documentation License:: How you can copy and share this manual.
  89. * Concept Index:: Index of programming concepts.
  90. * Function Index:: Index of C functions.
  91. * Datatype Index:: Index of C datatypes
  92. @end menu
  93. @c ---------------------------------------------------------------------
  94. @c Introduction to StarPU
  95. @c ---------------------------------------------------------------------
  96. @node Introduction
  97. @chapter Introduction to StarPU
  98. @include chapters/introduction.texi
  99. @c ---------------------------------------------------------------------
  100. @c Installing StarPU
  101. @c ---------------------------------------------------------------------
  102. @node Installing StarPU
  103. @chapter Installing StarPU
  104. @include chapters/installing.texi
  105. @c ---------------------------------------------------------------------
  106. @c Using StarPU
  107. @c ---------------------------------------------------------------------
  108. @node Using StarPU
  109. @chapter Using StarPU
  110. @include chapters/using.texi
  111. @c ---------------------------------------------------------------------
  112. @c Basic Examples
  113. @c ---------------------------------------------------------------------
  114. @node Basic Examples
  115. @chapter Basic Examples
  116. @include chapters/basic-examples.texi
  117. @c ---------------------------------------------------------------------
  118. @c Advanced Examples
  119. @c ---------------------------------------------------------------------
  120. @node Advanced Examples
  121. @chapter Advanced Examples
  122. @include chapters/advanced-examples.texi
  123. @c ---------------------------------------------------------------------
  124. @c Benchmarks
  125. @c ---------------------------------------------------------------------
  126. @node Benchmarks
  127. @chapter Benchmarks
  128. @include chapters/benchmarks.texi
  129. @c ---------------------------------------------------------------------
  130. @c Performance options
  131. @c ---------------------------------------------------------------------
  132. @node Performance optimization
  133. @chapter How to optimize performance with StarPU
  134. @include chapters/perf-optimization.texi
  135. @c ---------------------------------------------------------------------
  136. @c Performance feedback
  137. @c ---------------------------------------------------------------------
  138. @node Performance feedback
  139. @chapter Performance feedback
  140. @include chapters/perf-feedback.texi
  141. @c ---------------------------------------------------------------------
  142. @c Tips and Tricks
  143. @c ---------------------------------------------------------------------
  144. @node Tips and Tricks
  145. @chapter Tips and Tricks to know about
  146. @include chapters/tips-tricks.texi
  147. @c ---------------------------------------------------------------------
  148. @c MPI support
  149. @c ---------------------------------------------------------------------
  150. @node StarPU MPI support
  151. @chapter StarPU MPI support
  152. @include chapters/mpi-support.texi
  153. @c ---------------------------------------------------------------------
  154. @c FFT support
  155. @c ---------------------------------------------------------------------
  156. @node StarPU FFT support
  157. @chapter StarPU FFT support
  158. @include chapters/fft-support.texi
  159. @c ---------------------------------------------------------------------
  160. @c C Extensions
  161. @c ---------------------------------------------------------------------
  162. @node C Extensions
  163. @chapter C Extensions
  164. @include chapters/c-extensions.texi
  165. @c ---------------------------------------------------------------------
  166. @c SOCL
  167. @c ---------------------------------------------------------------------
  168. @node SOCL OpenCL Extensions
  169. @chapter SOCL OpenCL Extensions
  170. @include chapters/socl.texi
  171. @c ---------------------------------------------------------------------
  172. @c Scheduling Context Hypervisor
  173. @c ---------------------------------------------------------------------
  174. @node Scheduling Context Hypervisor
  175. @chapter Scheduling Context Hypervisor
  176. @include chapters/sched_ctx_hypervisor.texi
  177. @c ---------------------------------------------------------------------
  178. @c StarPU API
  179. @c ---------------------------------------------------------------------
  180. @node StarPU Basic API
  181. @chapter StarPU Basic API
  182. @include chapters/basic-api.texi
  183. @c ---------------------------------------------------------------------
  184. @c Advanced Topics
  185. @c ---------------------------------------------------------------------
  186. @node StarPU Advanced API
  187. @chapter StarPU Advanced API
  188. @include chapters/advanced-api.texi
  189. @c ---------------------------------------------------------------------
  190. @c Configuration options
  191. @c ---------------------------------------------------------------------
  192. @node Configuring StarPU
  193. @chapter Configuring StarPU
  194. @include chapters/configuration.texi
  195. @c ---------------------------------------------------------------------
  196. @c Appendices
  197. @c ---------------------------------------------------------------------
  198. @c ---------------------------------------------------------------------
  199. @c Full source code for the 'Scaling a Vector' example
  200. @c ---------------------------------------------------------------------
  201. @node Full source code for the 'Scaling a Vector' example
  202. @appendix Full source code for the 'Scaling a Vector' example
  203. @include chapters/scaling-vector-example.texi
  204. @c ---------------------------------------------------------------------
  205. @c License
  206. @c ---------------------------------------------------------------------
  207. @node GNU Free Documentation License
  208. @appendix GNU Free Documentation License
  209. @include chapters/fdl-1.3.texi
  210. @c ---------------------------------------------------------------------
  211. @c Indices
  212. @c ---------------------------------------------------------------------
  213. @c comment it out for now, it is too small to be kept for now. See how
  214. @c it can be merged with the glossary section in the introduction
  215. @node Concept Index
  216. @unnumbered Concept Index
  217. @printindex cp
  218. @node Function Index
  219. @unnumbered Function Index
  220. @printindex fn
  221. @node Datatype Index
  222. @unnumbered Datatype Index
  223. @printindex tp
  224. @bye