starpu.texi 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268
  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. * Introduction:: Getting started
  53. * Installing StarPU:: How to configure, build and install StarPU
  54. * Using StarPU:: How to run StarPU application
  55. * Basic Examples:: Basic examples of the use of StarPU
  56. * Advanced Examples:: Advanced examples of the use of StarPU
  57. * Benchmarks:: Benchmarks worth running
  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. * Full source code for the 'Scaling a Vector' example::
  70. * GNU Free Documentation License:: How you can copy and share this manual.
  71. * Concept Index:: Index of programming concepts.
  72. * Function Index:: Index of C functions.
  73. * Datatype Index:: Index of C datatypes
  74. @end menu
  75. @c ---------------------------------------------------------------------
  76. @c Introduction to StarPU
  77. @c ---------------------------------------------------------------------
  78. @node Introduction
  79. @chapter Introduction to StarPU
  80. @include chapters/introduction.texi
  81. @c ---------------------------------------------------------------------
  82. @c Installing StarPU
  83. @c ---------------------------------------------------------------------
  84. @node Installing StarPU
  85. @chapter Installing StarPU
  86. @include chapters/installing.texi
  87. @c ---------------------------------------------------------------------
  88. @c Using StarPU
  89. @c ---------------------------------------------------------------------
  90. @node Using StarPU
  91. @chapter Using StarPU
  92. @include chapters/using.texi
  93. @c ---------------------------------------------------------------------
  94. @c Basic Examples
  95. @c ---------------------------------------------------------------------
  96. @node Basic Examples
  97. @chapter Basic Examples
  98. @include chapters/basic-examples.texi
  99. @c ---------------------------------------------------------------------
  100. @c Advanced Examples
  101. @c ---------------------------------------------------------------------
  102. @node Advanced Examples
  103. @chapter Advanced Examples
  104. @include chapters/advanced-examples.texi
  105. @c ---------------------------------------------------------------------
  106. @c Benchmarks
  107. @c ---------------------------------------------------------------------
  108. @node Benchmarks
  109. @chapter Benchmarks
  110. @include chapters/benchmarks.texi
  111. @c ---------------------------------------------------------------------
  112. @c Performance options
  113. @c ---------------------------------------------------------------------
  114. @node Performance optimization
  115. @chapter How to optimize performance with StarPU
  116. @include chapters/perf-optimization.texi
  117. @c ---------------------------------------------------------------------
  118. @c Performance feedback
  119. @c ---------------------------------------------------------------------
  120. @node Performance feedback
  121. @chapter Performance feedback
  122. @include chapters/perf-feedback.texi
  123. @c ---------------------------------------------------------------------
  124. @c Tips and Tricks
  125. @c ---------------------------------------------------------------------
  126. @node Tips and Tricks
  127. @chapter Tips and Tricks to know about
  128. @include chapters/tips-tricks.texi
  129. @c ---------------------------------------------------------------------
  130. @c MPI support
  131. @c ---------------------------------------------------------------------
  132. @node StarPU MPI support
  133. @chapter StarPU MPI support
  134. @include chapters/mpi-support.texi
  135. @c ---------------------------------------------------------------------
  136. @c FFT support
  137. @c ---------------------------------------------------------------------
  138. @node StarPU FFT support
  139. @chapter StarPU FFT support
  140. @include chapters/fft-support.texi
  141. @c ---------------------------------------------------------------------
  142. @c C Extensions
  143. @c ---------------------------------------------------------------------
  144. @node C Extensions
  145. @chapter C Extensions
  146. @include chapters/c-extensions.texi
  147. @c ---------------------------------------------------------------------
  148. @c SOCL
  149. @c ---------------------------------------------------------------------
  150. @node SOCL OpenCL Extensions
  151. @chapter SOCL OpenCL Extensions
  152. @include chapters/socl.texi
  153. @c ---------------------------------------------------------------------
  154. @c Scheduling Context Hypervisor
  155. @c ---------------------------------------------------------------------
  156. @node Scheduling Context Hypervisor
  157. @chapter Scheduling Context Hypervisor
  158. @include chapters/sched_ctx_hypervisor.texi
  159. @c ---------------------------------------------------------------------
  160. @c StarPU API
  161. @c ---------------------------------------------------------------------
  162. @node StarPU Basic API
  163. @chapter StarPU Basic API
  164. @include chapters/basic-api.texi
  165. @c ---------------------------------------------------------------------
  166. @c Advanced Topics
  167. @c ---------------------------------------------------------------------
  168. @node StarPU Advanced API
  169. @chapter StarPU Advanced API
  170. @include chapters/advanced-api.texi
  171. @c ---------------------------------------------------------------------
  172. @c Configuration options
  173. @c ---------------------------------------------------------------------
  174. @node Configuring StarPU
  175. @chapter Configuring StarPU
  176. @include chapters/configuration.texi
  177. @c ---------------------------------------------------------------------
  178. @c Appendices
  179. @c ---------------------------------------------------------------------
  180. @c ---------------------------------------------------------------------
  181. @c Full source code for the 'Scaling a Vector' example
  182. @c ---------------------------------------------------------------------
  183. @node Full source code for the 'Scaling a Vector' example
  184. @appendix Full source code for the 'Scaling a Vector' example
  185. @include chapters/scaling-vector-example.texi
  186. @c ---------------------------------------------------------------------
  187. @c License
  188. @c ---------------------------------------------------------------------
  189. @node GNU Free Documentation License
  190. @appendix GNU Free Documentation License
  191. @include chapters/fdl-1.3.texi
  192. @c ---------------------------------------------------------------------
  193. @c Indices
  194. @c ---------------------------------------------------------------------
  195. @c comment it out for now, it is too small to be kept for now. See how
  196. @c it can be merged with the glossary section in the introduction
  197. @node Concept Index
  198. @unnumbered Concept Index
  199. @printindex cp
  200. @node Function Index
  201. @unnumbered Function Index
  202. @printindex fn
  203. @node Datatype Index
  204. @unnumbered Datatype Index
  205. @printindex tp
  206. @bye