refman.tex 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298
  1. \documentclass{book}
  2. \usepackage[a4paper,top=2.5cm,bottom=2.5cm,left=2.5cm,right=2.5cm]{geometry}
  3. \usepackage{makeidx}
  4. \usepackage{natbib}
  5. \usepackage{graphicx}
  6. \usepackage{multicol}
  7. \usepackage{float}
  8. \usepackage{listings}
  9. \usepackage{color}
  10. \usepackage{ifthen}
  11. \usepackage[table]{xcolor}
  12. \usepackage{textcomp}
  13. \usepackage{alltt}
  14. \usepackage{ifpdf}
  15. \usepackage{./version}
  16. \ifpdf
  17. \usepackage[pdftex,
  18. pagebackref=true,
  19. colorlinks=true,
  20. linkcolor=blue,
  21. unicode
  22. ]{hyperref}
  23. \else
  24. \usepackage[ps2pdf,
  25. pagebackref=true,
  26. colorlinks=true,
  27. linkcolor=blue,
  28. unicode
  29. ]{hyperref}
  30. \usepackage{pspicture}
  31. \fi
  32. \usepackage[utf8]{inputenc}
  33. \usepackage{mathptmx}
  34. \usepackage[scaled=.90]{helvet}
  35. \usepackage{courier}
  36. \usepackage{sectsty}
  37. \usepackage{amssymb}
  38. \usepackage[titles]{tocloft}
  39. \usepackage{doxygen}
  40. \lstset{language=C++,inputencoding=utf8,basicstyle=\footnotesize,breaklines=true,breakatwhitespace=true,tabsize=8,numbers=left }
  41. \makeindex
  42. \setcounter{tocdepth}{3}
  43. \renewcommand{\footrulewidth}{0.4pt}
  44. \renewcommand{\familydefault}{\sfdefault}
  45. \hfuzz=15pt
  46. \setlength{\emergencystretch}{15pt}
  47. \hbadness=750
  48. \tolerance=750
  49. \begin{document}
  50. \hypersetup{pageanchor=false,citecolor=blue}
  51. \begin{titlepage}
  52. \vspace*{4cm}
  53. {\Huge \textbf{StarPU Handbook}}\\
  54. \rule{\textwidth}{1.5mm}
  55. \begin{flushright}
  56. {\Large for StarPU \STARPUVERSION}
  57. \end{flushright}
  58. \rule{\textwidth}{1mm}
  59. ~\\
  60. \vspace*{15cm}
  61. \begin{flushright}
  62. Generated by Doxygen $doxygenversion on $datetime
  63. \end{flushright}
  64. \end{titlepage}
  65. \begin{figure}[p]
  66. This manual documents the usage of StarPU version \STARPUVERSION. Its contents
  67. was last updated on \STARPUUPDATED.\\
  68. Copyright © 2009–2013 Université de Bordeaux 1\\
  69. Copyright © 2010-2013 Centre National de la Recherche Scientifique\\
  70. Copyright © 2011, 2012 Institut National de Recherche en Informatique et Automatique\\
  71. \medskip
  72. \begin{quote}
  73. Permission is granted to copy, distribute and/or modify this document
  74. under the terms of the GNU Free Documentation License, Version 1.3 or
  75. any later version published by the Free Software Foundation; with no
  76. Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
  77. copy of the license is included in the section entitled “GNU Free
  78. Documentation License”.
  79. \end{quote}
  80. \end{figure}
  81. \clearemptydoublepage
  82. \pagenumbering{roman}
  83. \tableofcontents
  84. \clearemptydoublepage
  85. \pagenumbering{arabic}
  86. \hypersetup{pageanchor=true,citecolor=blue}
  87. \chapter{Introduction}
  88. \label{index}
  89. \hypertarget{index}{}
  90. \input{index}
  91. \part{Using StarPU}
  92. \chapter{Building and Installing StarPU}
  93. \label{BuildingAndInstallingStarPU}
  94. \hypertarget{BuildingAndInstallingStarPU}{}
  95. \input{BuildingAndInstallingStarPU}
  96. \chapter{Basic Examples}
  97. \label{BasicExamples}
  98. \hypertarget{BasicExamples}{}
  99. \input{BasicExamples}
  100. \chapter{Advanced Examples}
  101. \label{AdvancedExamples}
  102. \hypertarget{AdvancedExamples}{}
  103. \input{AdvancedExamples}
  104. \chapter{How To Optimize Performance With StarPU}
  105. \label{HowToOptimizePerformanceWithStarPU}
  106. \hypertarget{HowToOptimizePerformanceWithStarPU}{}
  107. \input{HowToOptimizePerformanceWithStarPU}
  108. \chapter{Performance Feedback}
  109. \label{PerformanceFeedback}
  110. \hypertarget{PerformanceFeedback}{}
  111. \input{PerformanceFeedback}
  112. \chapter{Tips and Tricks To Know About}
  113. \label{TipsAndTricksToKnowAbout}
  114. \hypertarget{TipsAndTricksToKnowAbout}{}
  115. \input{TipsAndTricksToKnowAbout}
  116. \chapter{Out Of Core}
  117. \label{OutOfCore}
  118. \hypertarget{OutOfCore}{}
  119. \input{OutOfCore}
  120. \chapter{MPI Support}
  121. \label{MPISupport}
  122. \hypertarget{MPISupport}{}
  123. \input{MPISupport}
  124. \chapter{FFT Support}
  125. \label{FFTSupport}
  126. \hypertarget{FFTSupport}{}
  127. \input{FFTSupport}
  128. \chapter{MIC/SCC Support}
  129. \label{MICSCCSupport}
  130. \hypertarget{MICSCCSupport}{}
  131. \input{MICSCCSupport}
  132. \chapter{C Extensions}
  133. \label{cExtensions}
  134. \hypertarget{cExtensions}{}
  135. \input{cExtensions}
  136. \chapter{SOCL OpenCL Extensions}
  137. \label{SOCLOpenclExtensions}
  138. \hypertarget{SOCLOpenclExtensions}{}
  139. \input{SOCLOpenclExtensions}
  140. \chapter{Scheduling Contexts}
  141. \label{SchedulingContexts}
  142. \hypertarget{SchedulingContexts}{}
  143. \input{SchedulingContexts}
  144. \chapter{Scheduling Context Hypervisor}
  145. \label{SchedulingContextHypervisor}
  146. \hypertarget{SchedulingContextHypervisor}{}
  147. \input{SchedulingContextHypervisor}
  148. \part{Inside StarPU}
  149. \chapter{Execution Configuration Through Environment Variables}
  150. \label{ExecutionConfigurationThroughEnvironmentVariables}
  151. \hypertarget{ExecutionConfigurationThroughEnvironmentVariables}{}
  152. \input{ExecutionConfigurationThroughEnvironmentVariables}
  153. \chapter{Compilation Configuration}
  154. \label{CompilationConfiguration}
  155. \hypertarget{CompilationConfiguration}{}
  156. \input{CompilationConfiguration}
  157. \chapter{Module Index}
  158. \input{modules}
  159. \chapter{Module Documentation a.k.a StarPU's API}
  160. \label{ModuleDocumentation}
  161. \hypertarget{ModuleDocumentation}{}
  162. \input{group__API__Versioning}
  163. \input{group__API__Initialization__and__Termination}
  164. \input{group__API__Standard__Memory__Library}
  165. \input{group__API__Toolbox}
  166. \input{group__API__Threads}
  167. \input{group__API__Workers__Properties}
  168. \input{group__API__Data__Management}
  169. \input{group__API__Data__Interfaces}
  170. \input{group__API__Data__Partition}
  171. \input{group__API__Out__Of__Core}
  172. \input{group__API__Multiformat__Data__Interface}
  173. \input{group__API__Codelet__And__Tasks}
  174. \input{group__API__Insert__Task}
  175. \input{group__API__Explicit__Dependencies}
  176. \input{group__API__Implicit__Data__Dependencies}
  177. \input{group__API__Performance__Model}
  178. \input{group__API__Profiling}
  179. \input{group__API__Theoretical__Lower__Bound__on__Execution__Time}
  180. \input{group__API__CUDA__Extensions}
  181. \input{group__API__OpenCL__Extensions}
  182. \input{group__API__MIC__Extensions}
  183. \input{group__API__SCC__Extensions}
  184. \input{group__API__Miscellaneous__Helpers}
  185. \input{group__API__FxT__Support}
  186. \input{group__API__FFT__Support}
  187. \input{group__API__MPI__Support}
  188. \input{group__API__Task__Bundles}
  189. \input{group__API__Task__Lists}
  190. \input{group__API__Parallel__Tasks}
  191. \input{group__API__Running__Drivers}
  192. \input{group__API__Expert__Mode}
  193. \input{group__API__StarPUTop__Interface}
  194. \input{group__API__Scheduling__Contexts}
  195. \input{group__API__Scheduling__Policy}
  196. \input{group__API__Scheduling__Context__Hypervisor}
  197. \chapter{File Index}
  198. \input{files}
  199. \chapter{File Documentation}
  200. \label{FileDocumentation}
  201. \hypertarget{FileDocumentation}{}
  202. \input{starpu_8h}
  203. \input{starpu__bound_8h}
  204. \input{starpu__config_8h}
  205. \input{starpu__cublas_8h}
  206. \input{starpu__cuda_8h}
  207. \input{starpu__data_8h}
  208. \input{starpu__data__filters_8h}
  209. \input{starpu__data__interfaces_8h}
  210. \input{starpu__deprecated__api_8h}
  211. \input{starpu__disk_8h}
  212. \input{starpu__driver_8h}
  213. \input{starpu__expert_8h}
  214. \input{starpu__fxt_8h}
  215. \input{starpu__hash_8h}
  216. \input{starpu__mic_8h}
  217. \input{starpu__opencl_8h}
  218. \input{starpu__perfmodel_8h}
  219. \input{starpu__profiling_8h}
  220. \input{starpu__rand_8h}
  221. \input{starpu__scc_8h}
  222. \input{starpu__sched__ctx_8h}
  223. \input{starpu__scheduler_8h}
  224. \input{starpu__sink_8h}
  225. \input{starpu__stdlib_8h}
  226. \input{starpu__task_8h}
  227. \input{starpu__task__bundle_8h}
  228. \input{starpu__task__list_8h}
  229. \input{starpu__task__util_8h}
  230. \input{starpu__thread_8h}
  231. \input{starpu__thread__util_8h}
  232. \input{starpu__top_8h}
  233. \input{starpu__util_8h}
  234. \input{starpu__worker_8h}
  235. \input{starpu__mpi_8h}
  236. \input{sc__hypervisor_8h}
  237. \input{sc__hypervisor__config_8h}
  238. \input{sc__hypervisor__lp_8h}
  239. \input{sc__hypervisor__monitoring_8h}
  240. \input{sc__hypervisor__policy_8h}
  241. \chapter{Deprecated List}
  242. \label{deprecated}
  243. \hypertarget{deprecated}{}
  244. \input{deprecated}
  245. \addcontentsline{toc}{chapter}{Index}
  246. \printindex
  247. \part{Appendix}
  248. \chapter{Full Source Code for the ’Scaling a Vector’ Example}
  249. \label{FullSourceCodeVectorScal}
  250. \hypertarget{FullSourceCodeVectorScal}{}
  251. \input{FullSourceCodeVectorScal}
  252. \chapter{GNU Free Documentation License}
  253. \label{GNUFreeDocumentationLicense}
  254. \hypertarget{GNUFreeDocumentationLicense}{}
  255. \input{GNUFreeDocumentationLicense}
  256. \end{document}