refman.tex 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241
  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{MPI Support}
  117. \label{MPISupport}
  118. \hypertarget{MPISupport}{}
  119. \input{MPISupport}
  120. \chapter{FFT Support}
  121. \label{FFTSupport}
  122. \hypertarget{FFTSupport}{}
  123. \input{FFTSupport}
  124. \chapter{MIC/SCC Support}
  125. \label{MICSCCSupport}
  126. \hypertarget{MICSCCSupport}{}
  127. \input{MICSCCSupport}
  128. \chapter{C Extensions}
  129. \label{cExtensions}
  130. \hypertarget{cExtensions}{}
  131. \input{cExtensions}
  132. \chapter{SOCL OpenCL Extensions}
  133. \label{SOCLOpenclExtensions}
  134. \hypertarget{SOCLOpenclExtensions}{}
  135. \input{SOCLOpenclExtensions}
  136. \chapter{Scheduling Contexts}
  137. \label{SchedulingContexts}
  138. \hypertarget{SchedulingContexts}{}
  139. \input{SchedulingContexts}
  140. \chapter{Scheduling Context Hypervisor}
  141. \label{SchedulingContextHypervisor}
  142. \hypertarget{SchedulingContextHypervisor}{}
  143. \input{SchedulingContextHypervisor}
  144. \part{Inside StarPU}
  145. \chapter{Execution Configuration Through Environment Variables}
  146. \label{ExecutionConfigurationThroughEnvironmentVariables}
  147. \hypertarget{ExecutionConfigurationThroughEnvironmentVariables}{}
  148. \input{ExecutionConfigurationThroughEnvironmentVariables}
  149. \chapter{Compilation Configuration}
  150. \label{CompilationConfiguration}
  151. \hypertarget{CompilationConfiguration}{}
  152. \input{CompilationConfiguration}
  153. \chapter{Module Index}
  154. \input{modules}
  155. \chapter{Module Documentation a.k.a StarPU's API}
  156. \label{ModuleDocumentation}
  157. \hypertarget{ModuleDocumentation}{}
  158. \input{group__API__Versioning}
  159. \input{group__API__Initialization__and__Termination}
  160. \input{group__API__Standard__Memory__Library}
  161. \input{group__API__Workers__Properties}
  162. \input{group__API__Data__Management}
  163. \input{group__API__Data__Interfaces}
  164. \input{group__API__Data__Partition}
  165. \input{group__API__Multiformat__Data__Interface}
  166. \input{group__API__Codelet__And__Tasks}
  167. \input{group__API__Insert__Task}
  168. \input{group__API__Explicit__Dependencies}
  169. \input{group__API__Implicit__Data__Dependencies}
  170. \input{group__API__Performance__Model}
  171. \input{group__API__Profiling}
  172. \input{group__API__Theoretical__Lower__Bound__on__Execution__Time}
  173. \input{group__API__CUDA__Extensions}
  174. \input{group__API__OpenCL__Extensions}
  175. \input{group__API__MIC__Extensions}
  176. \input{group__API__SCC__Extensions}
  177. \input{group__API__Miscellaneous__Helpers}
  178. \input{group__API__FxT__Support}
  179. \input{group__API__FFT__Support}
  180. \input{group__API__MPI__Support}
  181. \input{group__API__Task__Bundles}
  182. \input{group__API__Task__Lists}
  183. \input{group__API__Parallel__Tasks}
  184. \input{group__API__Running__Drivers}
  185. \input{group__API__Expert__Mode}
  186. \input{group__API__StarPUTop__Interface}
  187. \input{group__API__Scheduling__Contexts}
  188. \input{group__API__Scheduling__Policy}
  189. \input{group__API__Scheduling__Context__Hypervisor}
  190. \chapter{Deprecated List}
  191. \label{deprecated}
  192. \hypertarget{deprecated}{}
  193. \input{deprecated}
  194. \addcontentsline{toc}{chapter}{Index}
  195. \printindex
  196. \part{Appendix}
  197. \chapter{Full Source Code for the ’Scaling a Vector’ Example}
  198. \label{FullSourceCodeVectorScal}
  199. \hypertarget{FullSourceCodeVectorScal}{}
  200. \input{FullSourceCodeVectorScal}
  201. \chapter{GNU Free Documentation License}
  202. \label{GNUFreeDocumentationLicense}
  203. \hypertarget{GNUFreeDocumentationLicense}{}
  204. \input{GNUFreeDocumentationLicense}
  205. \end{document}