510_configure_options.doxy 22 KB

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