510_configure_options.doxy 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797
  1. /* StarPU --- Runtime system for heterogeneous multicore architectures.
  2. *
  3. * Copyright (C) 2009-2020 Université de Bordeaux, CNRS (LaBRI UMR 5800), Inria
  4. * Copyright (C) 2020 Federal University of Rio Grande do Sul (UFRGS)
  5. *
  6. * StarPU is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU Lesser General Public License as published by
  8. * the Free Software Foundation; either version 2.1 of the License, or (at
  9. * your option) any later version.
  10. *
  11. * StarPU is distributed in the hope that it will be useful, but
  12. * WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14. *
  15. * See the GNU Lesser General Public License in COPYING.LGPL for more details.
  16. */
  17. /*! \page CompilationConfiguration Compilation Configuration
  18. The behavior of the StarPU library and tools may be tuned thanks to
  19. the following configure options.
  20. \section CommonConfiguration Common Configuration
  21. <dl>
  22. <dt>--enable-debug</dt>
  23. <dd>
  24. \anchor enable-debug
  25. \addindex __configure__--enable-debug
  26. Enable debugging messages.
  27. </dd>
  28. <dt>--enable-spinlock-check</dt>
  29. <dd>
  30. \anchor enable-spinlock-check
  31. \addindex __configure__--enable-spinlock-check
  32. Enable checking that spinlocks are taken and released properly.
  33. </dd>
  34. <dt>--enable-fast</dt>
  35. <dd>
  36. \anchor enable-fast
  37. \addindex __configure__--enable-fast
  38. Disable assertion checks, which saves computation time.
  39. </dd>
  40. <dt>--enable-verbose</dt>
  41. <dd>
  42. \anchor enable-verbose
  43. \addindex __configure__--enable-verbose
  44. Increase the verbosity of the debugging messages. This can be disabled
  45. at runtime by setting the environment variable \ref STARPU_SILENT to
  46. any value. <c>--enable-verbose=extra</c> increase even more the verbosity.
  47. \verbatim
  48. $ STARPU_SILENT=1 ./vector_scal
  49. \endverbatim
  50. </dd>
  51. <dt>--enable-coverage</dt>
  52. <dd>
  53. \anchor enable-coverage
  54. \addindex __configure__--enable-coverage
  55. Enable flags for the coverage tool <c>gcov</c>.
  56. </dd>
  57. <dt>--enable-quick-check</dt>
  58. <dd>
  59. \anchor enable-quick-check
  60. \addindex __configure__--enable-quick-check
  61. Specify tests and examples should be run on a smaller data set, i.e
  62. allowing a faster execution time
  63. </dd>
  64. <dt>--enable-long-check</dt>
  65. <dd>
  66. \anchor enable-long-check
  67. \addindex __configure__--enable-long-check
  68. Enable some exhaustive checks which take a really long time.
  69. </dd>
  70. <dt>--enable-new-check</dt>
  71. <dd>
  72. \anchor enable-new-check
  73. \addindex __configure__--enable-new-check
  74. Enable new testcases which are known to fail.
  75. </dd>
  76. <dt>--with-hwloc</dt>
  77. <dd>
  78. \anchor with-hwloc
  79. \addindex __configure__--with-hwloc
  80. Specify <c>hwloc</c> should be used by StarPU. <c>hwloc</c> should be found by the
  81. means of the tool <c>pkg-config</c>.
  82. </dd>
  83. <dt>--with-hwloc=<c>prefix</c></dt>
  84. <dd>
  85. \anchor with-hwloc-prefix
  86. \addindex __configure__--with-hwloc-prefix
  87. Specify <c>hwloc</c> should be used by StarPU. <c>hwloc</c> should be found in the
  88. directory specified by <c>prefix</c>
  89. </dd>
  90. <dt>--without-hwloc</dt>
  91. <dd>
  92. \anchor without-hwloc
  93. \addindex __configure__--without-hwloc
  94. Specify <c>hwloc</c> should not be used by StarPU.
  95. </dd>
  96. <dt>--disable-build-doc</dt>
  97. <dd>
  98. \anchor disable-build-doc
  99. \addindex __configure__--disable-build-doc
  100. Disable the creation of the documentation. This should be done on a
  101. machine which does not have the tools <c>doxygen</c> and <c>latex</c>
  102. (plus the packages <c>latex-xcolor</c> and
  103. <c>texlive-latex-extra</c>).
  104. </dd>
  105. <dt>--enable-build-doc-pdf</dt>
  106. <dd>
  107. \anchor enable-build-doc-pdf
  108. \addindex __configure__--enable-build-doc-pdf
  109. By default, ontly the HTML documentation is generated. Use this option
  110. to also enable the generation of the PDF documentation. This should be
  111. done on a machine which does have the tools <c>doxygen</c> and <c>latex</c>
  112. (plus the packages <c>latex-xcolor</c> and
  113. <c>texlive-latex-extra</c>).
  114. </dd>
  115. <dt>--disable-icc</dt>
  116. <dd>
  117. \anchor disable-icc
  118. \addindex __configure__--disable-icc
  119. Disable the usage of the ICC compiler. When found, some specific ICC
  120. examples are compiled.
  121. </dd>
  122. </dl>
  123. Additionally, the script <c>configure</c> recognize many variables, which
  124. can be listed by typing <c>./configure --help</c>. For example,
  125. <c>./configure NVCCFLAGS="-arch sm_20"</c> adds a flag for the compilation of
  126. CUDA kernels, and <c>NVCC_CC=gcc-5</c> allows to change the C++ compiler
  127. used by nvcc.
  128. \section ConfiguringWorkers Configuring Workers
  129. <dl>
  130. <dt>--enable-blocking-drivers</dt>
  131. <dd>
  132. \anchor enable-blocking-drivers
  133. \addindex __configure__--enable-blocking-drivers
  134. By default, StarPU keeps CPU workers awake permanently, for better
  135. reactivity. This option makes StarPU put CPU workers to real sleep when there
  136. are not enough tasks to compute.
  137. </dd>
  138. <dt>--enable-worker-callbacks</dt>
  139. <dd>
  140. \anchor enable-worker-callbacks
  141. \addindex __configure__--enable-worker-callbacks
  142. If blocking drivers are enabled, enable callbacks to notify an external resource manager
  143. about workers going to sleep and waking up.
  144. </dd>
  145. <dt>--enable-maxcpus=<c>count</c></dt>
  146. <dd>
  147. \anchor enable-maxcpus
  148. \addindex __configure__--enable-maxcpus
  149. Use at most <c>count</c> CPU cores. This information is then
  150. available as the macro ::STARPU_MAXCPUS.
  151. </dd>
  152. <dt>--enable-maxnumanodes=<c>count</c></dt>
  153. <dd>
  154. \anchor enable-maxnumanodes
  155. \addindex __configure__--enable-maxnumanodes
  156. Use at most <c>count</c> NUMA nodes. This information is then
  157. available as the macro ::STARPU_MAXNUMANODES.
  158. </dd>
  159. <dt>--disable-cpu</dt>
  160. <dd>
  161. \anchor disable-cpu
  162. \addindex __configure__--disable-cpu
  163. Disable the use of CPUs of the machine. Only GPUs etc. will be used.
  164. </dd>
  165. <dt>--enable-maxcudadev=<c>count</c></dt>
  166. <dd>
  167. \anchor enable-maxcudadev
  168. \addindex __configure__--enable-maxcudadev
  169. Use at most <c>count</c> CUDA devices. This information is then
  170. available as the macro ::STARPU_MAXCUDADEVS.
  171. </dd>
  172. <dt>--disable-cuda</dt>
  173. <dd>
  174. \anchor disable-cuda
  175. \addindex __configure__--disable-cuda
  176. Disable the use of CUDA, even if a valid CUDA installation was detected.
  177. </dd>
  178. <dt>--with-cuda-dir=<c>prefix</c></dt>
  179. <dd>
  180. \anchor with-cuda-dir
  181. \addindex __configure__--with-cuda-dir
  182. Search for CUDA under <c>prefix</c>, which should notably contain the file
  183. <c>include/cuda.h</c>.
  184. </dd>
  185. <dt>--with-cuda-include-dir=<c>dir</c></dt>
  186. <dd>
  187. \anchor with-cuda-include-dir
  188. \addindex __configure__--with-cuda-include-dir
  189. Search for CUDA headers under <c>dir</c>, which should
  190. notably contain the file <c>cuda.h</c>. This defaults to
  191. <c>/include</c> appended to the value given to
  192. \ref with-cuda-dir "--with-cuda-dir".
  193. </dd>
  194. <dt>--with-cuda-lib-dir=<c>dir</c></dt>
  195. <dd>
  196. \anchor with-cuda-lib-dir
  197. \addindex __configure__--with-cuda-lib-dir
  198. Search for CUDA libraries under <c>dir</c>, which should notably contain
  199. the CUDA shared libraries---e.g., <c>libcuda.so</c>. This defaults to
  200. <c>/lib</c> appended to the value given to
  201. \ref with-cuda-dir "--with-cuda-dir".
  202. </dd>
  203. <dt>--disable-cuda-memcpy-peer</dt>
  204. <dd>
  205. \anchor disable-cuda-memcpy-peer
  206. \addindex __configure__--disable-cuda-memcpy-peer
  207. Explicitly disable peer transfers when using CUDA 4.0.
  208. </dd>
  209. <dt>--enable-maxopencldev=<c>count</c></dt>
  210. <dd>
  211. \anchor enable-maxopencldev
  212. \addindex __configure__--enable-maxopencldev
  213. Use at most <c>count</c> OpenCL devices. This information is then
  214. available as the macro ::STARPU_MAXOPENCLDEVS.
  215. </dd>
  216. <dt>--disable-opencl</dt>
  217. <dd>
  218. \anchor disable-opencl
  219. \addindex __configure__--disable-opencl
  220. Disable the use of OpenCL, even if the SDK is detected.
  221. </dd>
  222. <dt>--with-opencl-dir=<c>prefix</c></dt>
  223. <dd>
  224. \anchor with-opencl-dir
  225. \addindex __configure__--with-opencl-dir
  226. Search for an OpenCL implementation under <c>prefix</c>, which should
  227. notably contain <c>include/CL/cl.h</c> (or <c>include/OpenCL/cl.h</c>
  228. on Mac OS).
  229. </dd>
  230. <dt>--with-opencl-include-dir=<c>dir</c></dt>
  231. <dd>
  232. \anchor with-opencl-include-dir
  233. \addindex __configure__--with-opencl-include-dir
  234. Search for OpenCL headers under <c>dir</c>, which should notably contain
  235. <c>CL/cl.h</c> (or <c>OpenCL/cl.h</c> on Mac OS). This defaults to
  236. <c>/include</c> appended to the value given to
  237. \ref with-opencl-dir "--with-opencl-dir".
  238. </dd>
  239. <dt>--with-opencl-lib-dir=<c>dir</c></dt>
  240. <dd>
  241. \anchor with-opencl-lib-dir
  242. \addindex __configure__--with-opencl-lib-dir
  243. Search for an OpenCL library under <c>dir</c>, which should notably
  244. contain the OpenCL shared libraries---e.g. <c>libOpenCL.so</c>. This defaults to
  245. <c>/lib</c> appended to the value given to
  246. \ref with-opencl-dir "--with-opencl-dir".
  247. </dd>
  248. <dt>--enable-opencl-simulator</dt>
  249. <dd>
  250. \anchor enable-opencl-simulator
  251. \addindex __configure__--enable-opencl-simulator
  252. Enable considering the provided OpenCL implementation as a simulator, i.e. use
  253. the kernel duration returned by OpenCL profiling information as wallclock time
  254. instead of the actual measured real time. This requires the SimGrid support.
  255. </dd>
  256. <dt>--enable-maximplementations=<c>count</c></dt>
  257. <dd>
  258. \anchor enable-maximplementations
  259. \addindex __configure__--enable-maximplementations
  260. Allow for at most <c>count</c> codelet implementations for the same
  261. target device. This information is then available as the
  262. macro ::STARPU_MAXIMPLEMENTATIONS macro.
  263. </dd>
  264. <dt>--enable-max-sched-ctxs=<c>count</c></dt>
  265. <dd>
  266. \anchor enable-max-sched-ctxs
  267. \addindex __configure__--enable-max-sched-ctxs
  268. Allow for at most <c>count</c> scheduling contexts
  269. This information is then available as the macro
  270. ::STARPU_NMAX_SCHED_CTXS.
  271. </dd>
  272. <dt>--disable-asynchronous-copy</dt>
  273. <dd>
  274. \anchor disable-asynchronous-copy
  275. \addindex __configure__--disable-asynchronous-copy
  276. Disable asynchronous copies between CPU and GPU devices.
  277. The AMD implementation of OpenCL is known to
  278. fail when copying data asynchronously. When using this implementation,
  279. it is therefore necessary to disable asynchronous data transfers.
  280. </dd>
  281. <dt>--disable-asynchronous-cuda-copy</dt>
  282. <dd>
  283. \anchor disable-asynchronous-cuda-copy
  284. \addindex __configure__--disable-asynchronous-cuda-copy
  285. Disable asynchronous copies between CPU and CUDA devices.
  286. </dd>
  287. <dt>--disable-asynchronous-opencl-copy</dt>
  288. <dd>
  289. \anchor disable-asynchronous-opencl-copy
  290. \addindex __configure__--disable-asynchronous-opencl-copy
  291. Disable asynchronous copies between CPU and OpenCL devices.
  292. The AMD implementation of OpenCL is known to
  293. fail when copying data asynchronously. When using this implementation,
  294. it is therefore necessary to disable asynchronous data transfers.
  295. </dd>
  296. <dt>--enable-maxmicthreads</dt>
  297. <dd>
  298. \anchor enable-maxmicthreads
  299. \addindex __configure__--enable-maxmicthreads
  300. Specify the maximum number of MIC threads
  301. </dd>
  302. <dt>--disable-asynchronous-mic-copy</dt>
  303. <dd>
  304. \anchor disable-asynchronous-mic-copy
  305. \addindex __configure__--disable-asynchronous-mic-copy
  306. Disable asynchronous copies between CPU and MIC devices.
  307. </dd>
  308. <dt>--disable-asynchronous-mpi-master-slave-copy</dt>
  309. <dd>
  310. \anchor disable-asynchronous-mpi-master-slave-copy
  311. \addindex __configure__--disable-asynchronous-mpi-master-slave-copy
  312. Disable asynchronous copies between CPU and MPI Slave devices.
  313. </dd>
  314. <dt>--enable-maxnodes=<c>count</c></dt>
  315. <dd>
  316. \anchor enable-maxnodes
  317. \addindex __configure__--enable-maxnodes
  318. Use at most <c>count</c> memory nodes. This information is then available as
  319. the macro ::STARPU_MAXNODES. Reducing it allows to considerably reduce memory
  320. used by StarPU data structures.
  321. </dd>
  322. <dt>--with-fpga=<c>dir</c></dt>
  323. <dd>
  324. \anchor with-fpga
  325. \addindex __configure__--with-fpga
  326. Enable the FPGA driver support, and optionally specify the location of
  327. the FPGA library.
  328. </dd>
  329. <dt>--disable-asynchronous-fpga-copy</dt>
  330. <dd>
  331. \anchor disable-asynchronous-fpga-copy
  332. \addindex __configure__--disable-asynchronous-fpga-copy
  333. Disable asynchronous copies between CPU and FPGA devices.
  334. </dd>
  335. </dl>
  336. \section ExtensionConfiguration Extension Configuration
  337. <dl>
  338. <dt>--disable-mpi</dt>
  339. <dd>
  340. \anchor disable-mpi
  341. \addindex __configure__--disable-mpi
  342. Disable the build of libstarpumpi. By default, it is enabled when MPI is found.
  343. </dd>
  344. <dt>--enable-mpi</dt>
  345. <dd>
  346. \anchor enable-mpi
  347. \addindex __configure__--enable-mpi
  348. Enable the build of libstarpumpi. This is necessary when using Simgrid+MPI.
  349. </dd>
  350. <dt>--with-mpicc=<c>path</c></dt>
  351. <dd>
  352. \anchor with-mpicc
  353. \addindex __configure__--with-mpicc
  354. Use the compiler <c>mpicc</c> at <c>path</c>, for StarPU-MPI.
  355. (\ref MPISupport).
  356. </dd>
  357. <dt>--enable-mpi-pedantic-isend</dt>
  358. <dd>
  359. \anchor enable-mpi-pedantic-isend
  360. \addindex __configure__--enable-mpi-pedantic-isend
  361. Before performing any MPI communication, StarPU-MPI waits for the data
  362. to be available in the main memory of the node submitting the request.
  363. For send communications, data is acquired with the mode ::STARPU_R.
  364. When enabling the pedantic mode, data are instead acquired with the
  365. ::STARPU_RW which thus ensures that there is not more than 1
  366. concurrent MPI_Isend calls accessing the data
  367. and StarPU does not read from it from tasks during the communication.
  368. </dd>
  369. <dt>--enable-mpi-master-slave</dt>
  370. <dd>
  371. \anchor enable-mpi-master-slave
  372. \addindex __configure__--enable-mpi-master-slave
  373. Enable the MPI Master-Slave support. By default, it is disabled.
  374. </dd>
  375. <dt>--with-mpi-master-slave-multiple-thread</dt>
  376. <dd>
  377. \anchor with-mpi-master-slave-multiple-thread
  378. \addindex __configure__--with-mpi-master-slave-multiple-thread
  379. Create one thread per MPI Slave on the MPI master to manage communications.
  380. </dd>
  381. <dt>--enable-mpi-verbose</dt>
  382. <dd>
  383. \anchor enable-mpi-verbose
  384. \addindex __configure__--enable-mpi-verbose
  385. Increase the verbosity of the MPI debugging messages. This can be disabled
  386. at runtime by setting the environment variable \ref STARPU_SILENT to
  387. any value. <c>--enable-mpi-verbose=extra</c> increase even more the verbosity.
  388. \verbatim
  389. $ STARPU_SILENT=1 mpirun -np 2 ./insert_task
  390. \endverbatim
  391. </dd>
  392. <dt>--enable-nmad</dt>
  393. <dd>
  394. \anchor enable-nmad
  395. \addindex __configure__--enable-nmad
  396. Enable the NewMadeleine implementation for StarPU-MPI.
  397. </dd>
  398. <dt>--disable-fortran</dt>
  399. <dd>
  400. \anchor disable-fortran
  401. \addindex __configure__--disable-fortran
  402. Disable the fortran extension. By default, it is enabled when a
  403. fortran compiler is found.
  404. </dd>
  405. <dt>--disable-socl</dt>
  406. <dd>
  407. \anchor disable-socl
  408. \addindex __configure__--disable-socl
  409. Disable the SOCL extension (\ref SOCLOpenclExtensions). By
  410. default, it is enabled when an OpenCL implementation is found.
  411. </dd>
  412. <dt>--with-coi-dir</dt>
  413. <dd>
  414. \anchor with-coi-dir
  415. \addindex __configure__--with-coi-dir
  416. Specify the directory to the COI library for MIC support.
  417. The default value is <c>/opt/intel/mic/coi</c>
  418. </dd>
  419. <dt>--mic-host</dt>
  420. <dd>
  421. \anchor mic-host
  422. \addindex __configure__--mic-host
  423. Specify the precise MIC architecture host identifier.
  424. The default value is <c>x86_64-k1om-linux</c>
  425. </dd>
  426. <dt>--enable-openmp</dt>
  427. <dd>
  428. \anchor enable-openmp
  429. \addindex __configure__--enable-openmp
  430. Enable OpenMP Support (\ref OpenMPRuntimeSupport)
  431. </dd>
  432. <dt>--enable-cluster</dt>
  433. <dd>
  434. \anchor enable-cluster
  435. \addindex __configure__--enable-cluster
  436. Enable cluster Support (\ref ClusteringAMachine)
  437. </dd>
  438. </dl>
  439. \section AdvancedConfiguration Advanced Configuration
  440. <dl>
  441. <dt>--enable-perf-debug</dt>
  442. <dd>
  443. \anchor enable-perf-debug
  444. \addindex __configure__--enable-perf-debug
  445. Enable performance debugging through gprof.
  446. </dd>
  447. <dt>--enable-model-debug</dt>
  448. <dd>
  449. \anchor enable-model-debug
  450. \addindex __configure__--enable-model-debug
  451. Enable performance model debugging.
  452. </dd>
  453. <dt>--enable-fxt-lock</dt>
  454. <dd>
  455. \anchor enable-fxt-lock
  456. \addindex __configure__--enable-fxt-lock
  457. Enable additional trace events which describes locks behaviour. This is however
  458. extremely heavy and should only be enabled when debugging insides of StarPU.
  459. </dd>
  460. <dt>--enable-maxbuffers</dt>
  461. <dd>
  462. \anchor enable-maxbuffers
  463. \addindex __configure__--enable-maxbuffers
  464. Define the maximum number of buffers that tasks will be able to take
  465. as parameters, then available as the macro ::STARPU_NMAXBUFS.
  466. </dd>
  467. <dt>--enable-fxt-max-files=<c>count</c></dt>
  468. <dd>
  469. \anchor enable-fxt-max-files
  470. \addindex __configure__--enable-fxt-max-files
  471. Use at most <c>count</c> mpi nodes fxt files for generating traces. This information is then available as
  472. the macro ::STARPU_FXT_MAX_FILES. This information is used by FxT tools when considering multi node traces.
  473. Default value is 64.
  474. </dd>
  475. <dt>--enable-allocation-cache</dt>
  476. <dd>
  477. \anchor enable-allocation-cache
  478. \addindex __configure__--enable-allocation-cache
  479. Enable the use of a data allocation cache to avoid the cost of it with
  480. CUDA. Still experimental.
  481. </dd>
  482. <dt>--enable-opengl-render</dt>
  483. <dd>
  484. \anchor enable-opengl-render
  485. \addindex __configure__--enable-opengl-render
  486. Enable the use of OpenGL for the rendering of some examples.
  487. // TODO: rather default to enabled when detected
  488. </dd>
  489. <dt>--enable-blas-lib=<c>prefix</c></dt>
  490. <dd>
  491. \anchor enable-blas-lib
  492. \addindex __configure__--enable-blas-lib
  493. Specify the blas library to be used by some of the examples. Librairies available :
  494. - none [default] : no BLAS library is used
  495. - atlas: use ATLAS library
  496. - goto: use GotoBLAS library
  497. - openblas: use OpenBLAS library
  498. - mkl: use MKL library (you may need to set specific CFLAGS and LDFLAGS with --with-mkl-cflags and --with-mkl-ldflags)
  499. </dd>
  500. <dt>--enable-leveldb</dt>
  501. <dd>
  502. \anchor enable-leveldb
  503. \addindex __configure__--enable-leveldb
  504. Enable linking with LevelDB if available
  505. </dd>
  506. <dt>--enable-hdf5</dt>
  507. <dd>
  508. \anchor enable-hdf5
  509. \addindex __configure__--enable-hdf5
  510. Enable building HDF5 support.
  511. </dd>
  512. <dt>--with-hdf5-include-dir=<c>path</c></dt>
  513. <dd>
  514. \anchor with-hdf5-include-dir
  515. \addindex __configure__--with-hdf5-include-dir
  516. Specify the directory where is stored the header hdf5.h.
  517. </dd>
  518. <dt>--with-hdf5-lib-dir=<c>path</c></dt>
  519. <dd>
  520. \anchor with-hdf5-lib-dir
  521. \addindex __configure__--with-hdf5-lib-dir
  522. Specify the directory where is stored the hdf5 library.
  523. </dd>
  524. <dt>--disable-starpufft</dt>
  525. <dd>
  526. \anchor disable-starpufft
  527. \addindex __configure__--disable-starpufft
  528. Disable the build of libstarpufft, even if <c>fftw</c> or <c>cuFFT</c> is available.
  529. </dd>
  530. <dt>--enable-starpufft-examples</dt>
  531. <dd>
  532. \anchor enable-starpufft-examples
  533. \addindex __configure__--enable-starpufft-examples
  534. Enable the compilation and the execution of the libstarpufft examples.
  535. By default, they are neither compiled nor checked.
  536. </dd>
  537. <dt>--with-fxt=<c>prefix</c></dt>
  538. <dd>
  539. \anchor with-fxt
  540. \addindex __configure__--with-fxt
  541. Search for FxT under <c>prefix</c>.
  542. FxT (http://savannah.nongnu.org/projects/fkt) is used to generate
  543. traces of scheduling events, which can then be rendered them using ViTE
  544. (\ref Off-linePerformanceFeedback). <c>prefix</c> should
  545. notably contain <c>include/fxt/fxt.h</c>.
  546. </dd>
  547. <dt>--with-perf-model-dir=<c>dir</c></dt>
  548. <dd>
  549. \anchor with-perf-model-dir
  550. \addindex __configure__--with-perf-model-dir
  551. Store performance models under <c>dir</c>, instead of the current user's
  552. home.
  553. </dd>
  554. <dt>--with-goto-dir=<c>prefix</c></dt>
  555. <dd>
  556. \anchor with-goto-dir
  557. \addindex __configure__--with-goto-dir
  558. Search for GotoBLAS under <c>prefix</c>, which should notably contain
  559. <c>libgoto.so</c> or <c>libgoto2.so</c>.
  560. </dd>
  561. <dt>--with-atlas-dir=<c>prefix</c></dt>
  562. <dd>
  563. \anchor with-atlas-dir
  564. \addindex __configure__--with-atlas-dir
  565. Search for ATLAS under <c>prefix</c>, which should notably contain
  566. <c>include/cblas.h</c>.
  567. </dd>
  568. <dt>--with-mkl-cflags=<c>cflags</c></dt>
  569. <dd>
  570. \anchor with-mkl-cflags
  571. \addindex __configure__--with-mkl-cflags
  572. Use <c>cflags</c> to compile code that uses the MKL library.
  573. </dd>
  574. <dt>--with-mkl-ldflags=<c>ldflags</c></dt>
  575. <dd>
  576. \anchor with-mkl-ldflags
  577. \addindex __configure__--with-mkl-ldflags
  578. Use <c>ldflags</c> when linking code that uses the MKL library. Note
  579. that the MKL website
  580. (http://software.intel.com/en-us/articles/intel-mkl-link-line-advisor/)
  581. provides a script to determine the linking flags.
  582. </dd>
  583. <dt>--disable-glpk</dt>
  584. <dd>
  585. \anchor disable-glpk
  586. \addindex __configure__--disable-glpk
  587. Disable the use of libglpk for computing area bounds.
  588. </dd>
  589. <dt>--disable-build-tests</dt>
  590. <dd>
  591. \anchor disable-build-tests
  592. \addindex __configure__--disable-build-tests
  593. Disable the build of tests.
  594. </dd>
  595. <dt>--disable-build-examples</dt>
  596. <dd>
  597. \anchor disable-build-examples
  598. \addindex __configure__--disable-build-examples
  599. Disable the build of examples.
  600. </dd>
  601. <dt>--enable-sc-hypervisor</dt>
  602. <dd>
  603. \anchor enable-sc-hypervisor
  604. \addindex __configure__--enable-sc-hypervisor
  605. Enable the Scheduling Context Hypervisor plugin (\ref SchedulingContextHypervisor).
  606. By default, it is disabled.
  607. </dd>
  608. <dt>--enable-memory-stats</dt>
  609. <dd>
  610. \anchor enable-memory-stats
  611. \addindex __configure__--enable-memory-stats
  612. Enable memory statistics (\ref MemoryFeedback).
  613. </dd>
  614. <dt>--enable-simgrid</dt>
  615. <dd>
  616. \anchor enable-simgrid
  617. \addindex __configure__--enable-simgrid
  618. Enable simulation of execution in SimGrid, to allow easy experimentation with
  619. various numbers of cores and GPUs, or amount of memory, etc. Experimental.
  620. The path to SimGrid can be specified through the <c>SIMGRID_CFLAGS</c> and
  621. <c>SIMGRID_LIBS</c> environment variables, for instance:
  622. \verbatim
  623. export SIMGRID_CFLAGS="-I/usr/local/simgrid/include"
  624. export SIMGRID_LIBS="-L/usr/local/simgrid/lib -lsimgrid"
  625. \endverbatim
  626. </dd>
  627. <dt>--with-simgrid-dir</dt>
  628. <dd>
  629. \anchor with-simgrid-dir
  630. \addindex __configure__--with-simgrid-dir
  631. Similar to the option \ref enable-simgrid "--enable-simgrid" but also
  632. allows to specify the location to the SimGrid library.
  633. </dd>
  634. <dt>--with-simgrid-include-dir</dt>
  635. <dd>
  636. \anchor with-simgrid-include-dir
  637. \addindex __configure__--with-simgrid-include-dir
  638. Similar to the option \ref enable-simgrid "--enable-simgrid" but also
  639. allows to specify the location to the SimGrid include directory.
  640. </dd>
  641. <dt>--with-simgrid-lib-dir</dt>
  642. <dd>
  643. \anchor with-simgrid-lib-dir
  644. \addindex __configure__--with-simgrid-lib-dir
  645. Similar to the option \ref enable-simgrid "--enable-simgrid" but also
  646. allows to specify the location to the SimGrid lib directory.
  647. </dd>
  648. <dt>--with-smpirun=<c>path</c></dt>
  649. <dd>
  650. \anchor with-smpirun
  651. \addindex __configure__--with-smpirun
  652. Use the smpirun at <c>path</c>
  653. </dd>
  654. <dt>--enable-simgrid-mc</dt>
  655. <dd>
  656. \anchor enable-simgrid-mc
  657. \addindex __configure__--enable-simgrid-mc
  658. Enable the Model Checker in simulation of execution in SimGrid, to allow
  659. exploring various execution paths.
  660. </dd>
  661. <dt>--enable-calibration-heuristic</dt>
  662. <dd>
  663. \anchor enable-calibration-heuristic
  664. \addindex __configure__--enable-calibration-heuristic
  665. Allow to set the maximum authorized percentage of deviation
  666. for the history-based calibrator of StarPU. A correct value
  667. of this parameter must be in [0..100]. The default value of
  668. this parameter is 10. Experimental.
  669. </dd>
  670. <dt>--enable-mlr</dt>
  671. <dd>
  672. \anchor enable-mlr
  673. \addindex __configure__--enable-mlr
  674. Allow to enable multiple linear regression models (see \ref PerformanceModelExample)
  675. </dd>
  676. <dt>--enable-mlr-system-blas</dt>
  677. <dd>
  678. \anchor enable-mlr-system-blas
  679. \addindex __configure__--enable-mlr-system-blas
  680. Allow to make multiple linear regression models use the system-provided BLAS for dgels
  681. (see \ref PerformanceModelExample)
  682. </dd>
  683. </dl>
  684. */