starpu.texi 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284
  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. @node Top
  38. @top Preface
  39. This manual documents the usage of StarPU version @value{VERSION}. It
  40. was last updated on @value{UPDATED}.
  41. @ifnottex
  42. @insertcopying
  43. @end ifnottex
  44. @comment
  45. @comment When you add a new menu item, please keep the right hand
  46. @comment aligned to the same column. Do not use tabs. This provides
  47. @comment better formatting.
  48. @comment
  49. @menu
  50. <<<<<<< .working
  51. * Introduction:: Getting started
  52. * Installing StarPU:: How to configure, build and install StarPU
  53. * Using StarPU:: How to run StarPU application
  54. * Basic Examples:: Basic examples of the use of StarPU
  55. * Advanced Examples:: Advanced examples of the use of StarPU
  56. * Performance optimization:: How to optimize performance with StarPU
  57. * Performance feedback:: Performance debugging tools
  58. * Tips and Tricks:: Tips and tricks to know about
  59. * StarPU MPI support:: How to combine StarPU with MPI
  60. * StarPU FFT support:: How to perform FFT computations with StarPU
  61. * C Extensions:: Easier StarPU programming with GCC
  62. * SOCL OpenCL Extensions:: How to use OpenCL on top of StarPU
  63. * Scheduling Context Hypervisor:: How to use Scheduling Context Hypervisor with StarPU
  64. * StarPU Basic API:: The Basic API to use StarPU
  65. * StarPU Advanced API:: Advanced use of StarPU
  66. * Configuring StarPU:: How to configure StarPU
  67. =======
  68. * Introduction:: Getting started
  69. * Installing StarPU:: How to configure, build and install StarPU
  70. * Using StarPU:: How to run StarPU application
  71. * Basic Examples:: Basic examples of the use of StarPU
  72. * Advanced Examples:: Advanced examples of the use of StarPU
  73. * Performance optimization:: How to optimize performance with StarPU
  74. * Performance feedback:: Performance debugging tools
  75. * Tips and Tricks:: Tips and tricks to know about
  76. * StarPU MPI support:: How to combine StarPU with MPI
  77. * StarPU FFT support:: How to perform FFT computations with StarPU
  78. * C Extensions:: Easier StarPU programming with GCC
  79. * SOCL OpenCL Extensions:: How to use OpenCL on top of StarPU
  80. * Benchmarks:: Benchmarks worth running
  81. * StarPU Basic API:: The Basic API to use StarPU
  82. * StarPU Advanced API:: Advanced use of StarPU
  83. * Configuring StarPU:: How to configure StarPU
  84. >>>>>>> .merge-right.r7640
  85. * Full source code for the 'Scaling a Vector' example::
  86. * GNU Free Documentation License:: How you can copy and share this manual.
  87. * Concept Index:: Index of programming concepts.
  88. * Function Index:: Index of C functions.
  89. * Datatype Index:: Index of C datatypes
  90. @end menu
  91. @c ---------------------------------------------------------------------
  92. @c Introduction to StarPU
  93. @c ---------------------------------------------------------------------
  94. @node Introduction
  95. @chapter Introduction to StarPU
  96. @include chapters/introduction.texi
  97. @c ---------------------------------------------------------------------
  98. @c Installing StarPU
  99. @c ---------------------------------------------------------------------
  100. @node Installing StarPU
  101. @chapter Installing StarPU
  102. @include chapters/installing.texi
  103. @c ---------------------------------------------------------------------
  104. @c Using StarPU
  105. @c ---------------------------------------------------------------------
  106. @node Using StarPU
  107. @chapter Using StarPU
  108. @include chapters/using.texi
  109. @c ---------------------------------------------------------------------
  110. @c Basic Examples
  111. @c ---------------------------------------------------------------------
  112. @node Basic Examples
  113. @chapter Basic Examples
  114. @include chapters/basic-examples.texi
  115. @c ---------------------------------------------------------------------
  116. @c Advanced Examples
  117. @c ---------------------------------------------------------------------
  118. @node Advanced Examples
  119. @chapter Advanced Examples
  120. @include chapters/advanced-examples.texi
  121. @c ---------------------------------------------------------------------
  122. @c Benchmarks
  123. @c ---------------------------------------------------------------------
  124. @node Benchmarks
  125. @chapter Benchmarks
  126. @include chapters/benchmarks.texi
  127. @c ---------------------------------------------------------------------
  128. @c Performance options
  129. @c ---------------------------------------------------------------------
  130. @node Performance optimization
  131. @chapter How to optimize performance with StarPU
  132. @include chapters/perf-optimization.texi
  133. @c ---------------------------------------------------------------------
  134. @c Performance feedback
  135. @c ---------------------------------------------------------------------
  136. @node Performance feedback
  137. @chapter Performance feedback
  138. @include chapters/perf-feedback.texi
  139. @c ---------------------------------------------------------------------
  140. @c Tips and Tricks
  141. @c ---------------------------------------------------------------------
  142. @node Tips and Tricks
  143. @chapter Tips and Tricks to know about
  144. @include chapters/tips-tricks.texi
  145. @c ---------------------------------------------------------------------
  146. @c MPI support
  147. @c ---------------------------------------------------------------------
  148. @node StarPU MPI support
  149. @chapter StarPU MPI support
  150. @include chapters/mpi-support.texi
  151. @c ---------------------------------------------------------------------
  152. @c FFT support
  153. @c ---------------------------------------------------------------------
  154. @node StarPU FFT support
  155. @chapter StarPU FFT support
  156. @include chapters/fft-support.texi
  157. @c ---------------------------------------------------------------------
  158. @c C Extensions
  159. @c ---------------------------------------------------------------------
  160. @node C Extensions
  161. @chapter C Extensions
  162. @include chapters/c-extensions.texi
  163. @c ---------------------------------------------------------------------
  164. @c SOCL
  165. @c ---------------------------------------------------------------------
  166. @node SOCL OpenCL Extensions
  167. @chapter SOCL OpenCL Extensions
  168. @include chapters/socl.texi
  169. @c ---------------------------------------------------------------------
  170. @c Scheduling Context Hypervisor
  171. @c ---------------------------------------------------------------------
  172. @node Scheduling Context Hypervisor
  173. @chapter Scheduling Context Hypervisor
  174. @include chapters/sched_ctx_hypervisor.texi
  175. @c ---------------------------------------------------------------------
  176. @c StarPU API
  177. @c ---------------------------------------------------------------------
  178. @node StarPU Basic API
  179. @chapter StarPU Basic API
  180. @include chapters/basic-api.texi
  181. @c ---------------------------------------------------------------------
  182. @c Advanced Topics
  183. @c ---------------------------------------------------------------------
  184. @node StarPU Advanced API
  185. @chapter StarPU Advanced API
  186. @include chapters/advanced-api.texi
  187. @c ---------------------------------------------------------------------
  188. @c Configuration options
  189. @c ---------------------------------------------------------------------
  190. @node Configuring StarPU
  191. @chapter Configuring StarPU
  192. @include chapters/configuration.texi
  193. @c ---------------------------------------------------------------------
  194. @c Appendices
  195. @c ---------------------------------------------------------------------
  196. @c ---------------------------------------------------------------------
  197. @c Full source code for the 'Scaling a Vector' example
  198. @c ---------------------------------------------------------------------
  199. @node Full source code for the 'Scaling a Vector' example
  200. @appendix Full source code for the 'Scaling a Vector' example
  201. @include chapters/scaling-vector-example.texi
  202. @c ---------------------------------------------------------------------
  203. @c License
  204. @c ---------------------------------------------------------------------
  205. @node GNU Free Documentation License
  206. @appendix GNU Free Documentation License
  207. @include chapters/fdl-1.3.texi
  208. @c ---------------------------------------------------------------------
  209. @c Indices
  210. @c ---------------------------------------------------------------------
  211. @c comment it out for now, it is too small to be kept for now. See how
  212. @c it can be merged with the glossary section in the introduction
  213. @node Concept Index
  214. @unnumbered Concept Index
  215. @printindex cp
  216. @node Function Index
  217. @unnumbered Function Index
  218. @printindex fn
  219. @node Datatype Index
  220. @unnumbered Datatype Index
  221. @printindex tp
  222. @bye