510_configure_options.doxy 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782
  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. </dl>
  323. \section ExtensionConfiguration Extension Configuration
  324. <dl>
  325. <dt>--disable-mpi</dt>
  326. <dd>
  327. \anchor disable-mpi
  328. \addindex __configure__--disable-mpi
  329. Disable the build of libstarpumpi. By default, it is enabled when MPI is found.
  330. </dd>
  331. <dt>--enable-mpi</dt>
  332. <dd>
  333. \anchor enable-mpi
  334. \addindex __configure__--enable-mpi
  335. Enable the build of libstarpumpi. This is necessary when using Simgrid+MPI.
  336. </dd>
  337. <dt>--with-mpicc=<c>path</c></dt>
  338. <dd>
  339. \anchor with-mpicc
  340. \addindex __configure__--with-mpicc
  341. Use the compiler <c>mpicc</c> at <c>path</c>, for StarPU-MPI.
  342. (\ref MPISupport).
  343. </dd>
  344. <dt>--enable-mpi-pedantic-isend</dt>
  345. <dd>
  346. \anchor enable-mpi-pedantic-isend
  347. \addindex __configure__--enable-mpi-pedantic-isend
  348. Before performing any MPI communication, StarPU-MPI waits for the data
  349. to be available in the main memory of the node submitting the request.
  350. For send communications, data is acquired with the mode ::STARPU_R.
  351. When enabling the pedantic mode, data are instead acquired with the
  352. ::STARPU_RW which thus ensures that there is not more than 1
  353. concurrent MPI_Isend calls accessing the data
  354. and StarPU does not read from it from tasks during the communication.
  355. </dd>
  356. <dt>--enable-mpi-master-slave</dt>
  357. <dd>
  358. \anchor enable-mpi-master-slave
  359. \addindex __configure__--enable-mpi-master-slave
  360. Enable the MPI Master-Slave support. By default, it is disabled.
  361. </dd>
  362. <dt>--with-mpi-master-slave-multiple-thread</dt>
  363. <dd>
  364. \anchor with-mpi-master-slave-multiple-thread
  365. \addindex __configure__--with-mpi-master-slave-multiple-thread
  366. Create one thread per MPI Slave on the MPI master to manage communications.
  367. </dd>
  368. <dt>--enable-mpi-verbose</dt>
  369. <dd>
  370. \anchor enable-mpi-verbose
  371. \addindex __configure__--enable-mpi-verbose
  372. Increase the verbosity of the MPI debugging messages. This can be disabled
  373. at runtime by setting the environment variable \ref STARPU_SILENT to
  374. any value. <c>--enable-mpi-verbose=extra</c> increase even more the verbosity.
  375. \verbatim
  376. $ STARPU_SILENT=1 mpirun -np 2 ./insert_task
  377. \endverbatim
  378. </dd>
  379. <dt>--enable-nmad</dt>
  380. <dd>
  381. \anchor enable-nmad
  382. \addindex __configure__--enable-nmad
  383. Enable the NewMadeleine implementation for StarPU-MPI.
  384. </dd>
  385. <dt>--disable-fortran</dt>
  386. <dd>
  387. \anchor disable-fortran
  388. \addindex __configure__--disable-fortran
  389. Disable the fortran extension. By default, it is enabled when a
  390. fortran compiler is found.
  391. </dd>
  392. <dt>--disable-socl</dt>
  393. <dd>
  394. \anchor disable-socl
  395. \addindex __configure__--disable-socl
  396. Disable the SOCL extension (\ref SOCLOpenclExtensions). By
  397. default, it is enabled when an OpenCL implementation is found.
  398. </dd>
  399. <dt>--with-coi-dir</dt>
  400. <dd>
  401. \anchor with-coi-dir
  402. \addindex __configure__--with-coi-dir
  403. Specify the directory to the COI library for MIC support.
  404. The default value is <c>/opt/intel/mic/coi</c>
  405. </dd>
  406. <dt>--mic-host</dt>
  407. <dd>
  408. \anchor mic-host
  409. \addindex __configure__--mic-host
  410. Specify the precise MIC architecture host identifier.
  411. The default value is <c>x86_64-k1om-linux</c>
  412. </dd>
  413. <dt>--enable-openmp</dt>
  414. <dd>
  415. \anchor enable-openmp
  416. \addindex __configure__--enable-openmp
  417. Enable OpenMP Support (\ref OpenMPRuntimeSupport)
  418. </dd>
  419. <dt>--enable-cluster</dt>
  420. <dd>
  421. \anchor enable-cluster
  422. \addindex __configure__--enable-cluster
  423. Enable cluster Support (\ref ClusteringAMachine)
  424. </dd>
  425. </dl>
  426. \section AdvancedConfiguration Advanced Configuration
  427. <dl>
  428. <dt>--enable-perf-debug</dt>
  429. <dd>
  430. \anchor enable-perf-debug
  431. \addindex __configure__--enable-perf-debug
  432. Enable performance debugging through gprof.
  433. </dd>
  434. <dt>--enable-model-debug</dt>
  435. <dd>
  436. \anchor enable-model-debug
  437. \addindex __configure__--enable-model-debug
  438. Enable performance model debugging.
  439. </dd>
  440. <dt>--enable-fxt-lock</dt>
  441. <dd>
  442. \anchor enable-fxt-lock
  443. \addindex __configure__--enable-fxt-lock
  444. Enable additional trace events which describes locks behaviour. This is however
  445. extremely heavy and should only be enabled when debugging insides of StarPU.
  446. </dd>
  447. <dt>--enable-maxbuffers</dt>
  448. <dd>
  449. \anchor enable-maxbuffers
  450. \addindex __configure__--enable-maxbuffers
  451. Define the maximum number of buffers that tasks will be able to take
  452. as parameters, then available as the macro ::STARPU_NMAXBUFS.
  453. </dd>
  454. <dt>--enable-fxt-max-files=<c>count</c></dt>
  455. <dd>
  456. \anchor enable-fxt-max-files
  457. \addindex __configure__--enable-fxt-max-files
  458. Use at most <c>count</c> mpi nodes fxt files for generating traces. This information is then available as
  459. the macro ::STARPU_FXT_MAX_FILES. This information is used by FxT tools when considering multi node traces.
  460. Default value is 64.
  461. </dd>
  462. <dt>--enable-allocation-cache</dt>
  463. <dd>
  464. \anchor enable-allocation-cache
  465. \addindex __configure__--enable-allocation-cache
  466. Enable the use of a data allocation cache to avoid the cost of it with
  467. CUDA. Still experimental.
  468. </dd>
  469. <dt>--enable-opengl-render</dt>
  470. <dd>
  471. \anchor enable-opengl-render
  472. \addindex __configure__--enable-opengl-render
  473. Enable the use of OpenGL for the rendering of some examples.
  474. // TODO: rather default to enabled when detected
  475. </dd>
  476. <dt>--enable-blas-lib=<c>prefix</c></dt>
  477. <dd>
  478. \anchor enable-blas-lib
  479. \addindex __configure__--enable-blas-lib
  480. Specify the blas library to be used by some of the examples. Librairies available :
  481. - none [default] : no BLAS library is used
  482. - atlas: use ATLAS library
  483. - goto: use GotoBLAS library
  484. - openblas: use OpenBLAS library
  485. - mkl: use MKL library (you may need to set specific CFLAGS and LDFLAGS with --with-mkl-cflags and --with-mkl-ldflags)
  486. </dd>
  487. <dt>--enable-leveldb</dt>
  488. <dd>
  489. \anchor enable-leveldb
  490. \addindex __configure__--enable-leveldb
  491. Enable linking with LevelDB if available
  492. </dd>
  493. <dt>--enable-hdf5</dt>
  494. <dd>
  495. \anchor enable-hdf5
  496. \addindex __configure__--enable-hdf5
  497. Enable building HDF5 support.
  498. </dd>
  499. <dt>--with-hdf5-include-dir=<c>path</c></dt>
  500. <dd>
  501. \anchor with-hdf5-include-dir
  502. \addindex __configure__--with-hdf5-include-dir
  503. Specify the directory where is stored the header hdf5.h.
  504. </dd>
  505. <dt>--with-hdf5-lib-dir=<c>path</c></dt>
  506. <dd>
  507. \anchor with-hdf5-lib-dir
  508. \addindex __configure__--with-hdf5-lib-dir
  509. Specify the directory where is stored the hdf5 library.
  510. </dd>
  511. <dt>--disable-starpufft</dt>
  512. <dd>
  513. \anchor disable-starpufft
  514. \addindex __configure__--disable-starpufft
  515. Disable the build of libstarpufft, even if <c>fftw</c> or <c>cuFFT</c> is available.
  516. </dd>
  517. <dt>--enable-starpufft-examples</dt>
  518. <dd>
  519. \anchor enable-starpufft-examples
  520. \addindex __configure__--enable-starpufft-examples
  521. Enable the compilation and the execution of the libstarpufft examples.
  522. By default, they are neither compiled nor checked.
  523. </dd>
  524. <dt>--with-fxt=<c>prefix</c></dt>
  525. <dd>
  526. \anchor with-fxt
  527. \addindex __configure__--with-fxt
  528. Search for FxT under <c>prefix</c>.
  529. FxT (http://savannah.nongnu.org/projects/fkt) is used to generate
  530. traces of scheduling events, which can then be rendered them using ViTE
  531. (\ref Off-linePerformanceFeedback). <c>prefix</c> should
  532. notably contain <c>include/fxt/fxt.h</c>.
  533. </dd>
  534. <dt>--with-perf-model-dir=<c>dir</c></dt>
  535. <dd>
  536. \anchor with-perf-model-dir
  537. \addindex __configure__--with-perf-model-dir
  538. Store performance models under <c>dir</c>, instead of the current user's
  539. home.
  540. </dd>
  541. <dt>--with-goto-dir=<c>prefix</c></dt>
  542. <dd>
  543. \anchor with-goto-dir
  544. \addindex __configure__--with-goto-dir
  545. Search for GotoBLAS under <c>prefix</c>, which should notably contain
  546. <c>libgoto.so</c> or <c>libgoto2.so</c>.
  547. </dd>
  548. <dt>--with-atlas-dir=<c>prefix</c></dt>
  549. <dd>
  550. \anchor with-atlas-dir
  551. \addindex __configure__--with-atlas-dir
  552. Search for ATLAS under <c>prefix</c>, which should notably contain
  553. <c>include/cblas.h</c>.
  554. </dd>
  555. <dt>--with-mkl-cflags=<c>cflags</c></dt>
  556. <dd>
  557. \anchor with-mkl-cflags
  558. \addindex __configure__--with-mkl-cflags
  559. Use <c>cflags</c> to compile code that uses the MKL library.
  560. </dd>
  561. <dt>--with-mkl-ldflags=<c>ldflags</c></dt>
  562. <dd>
  563. \anchor with-mkl-ldflags
  564. \addindex __configure__--with-mkl-ldflags
  565. Use <c>ldflags</c> when linking code that uses the MKL library. Note
  566. that the MKL website
  567. (http://software.intel.com/en-us/articles/intel-mkl-link-line-advisor/)
  568. provides a script to determine the linking flags.
  569. </dd>
  570. <dt>--disable-glpk</dt>
  571. <dd>
  572. \anchor disable-glpk
  573. \addindex __configure__--disable-glpk
  574. Disable the use of libglpk for computing area bounds.
  575. </dd>
  576. <dt>--disable-build-tests</dt>
  577. <dd>
  578. \anchor disable-build-tests
  579. \addindex __configure__--disable-build-tests
  580. Disable the build of tests.
  581. </dd>
  582. <dt>--disable-build-examples</dt>
  583. <dd>
  584. \anchor disable-build-examples
  585. \addindex __configure__--disable-build-examples
  586. Disable the build of examples.
  587. </dd>
  588. <dt>--enable-sc-hypervisor</dt>
  589. <dd>
  590. \anchor enable-sc-hypervisor
  591. \addindex __configure__--enable-sc-hypervisor
  592. Enable the Scheduling Context Hypervisor plugin (\ref SchedulingContextHypervisor).
  593. By default, it is disabled.
  594. </dd>
  595. <dt>--enable-memory-stats</dt>
  596. <dd>
  597. \anchor enable-memory-stats
  598. \addindex __configure__--enable-memory-stats
  599. Enable memory statistics (\ref MemoryFeedback).
  600. </dd>
  601. <dt>--enable-simgrid</dt>
  602. <dd>
  603. \anchor enable-simgrid
  604. \addindex __configure__--enable-simgrid
  605. Enable simulation of execution in SimGrid, to allow easy experimentation with
  606. various numbers of cores and GPUs, or amount of memory, etc. Experimental.
  607. The path to SimGrid can be specified through the <c>SIMGRID_CFLAGS</c> and
  608. <c>SIMGRID_LIBS</c> environment variables, for instance:
  609. \verbatim
  610. export SIMGRID_CFLAGS="-I/usr/local/simgrid/include"
  611. export SIMGRID_LIBS="-L/usr/local/simgrid/lib -lsimgrid"
  612. \endverbatim
  613. </dd>
  614. <dt>--with-simgrid-dir</dt>
  615. <dd>
  616. \anchor with-simgrid-dir
  617. \addindex __configure__--with-simgrid-dir
  618. Similar to the option \ref enable-simgrid "--enable-simgrid" but also
  619. allows to specify the location to the SimGrid library.
  620. </dd>
  621. <dt>--with-simgrid-include-dir</dt>
  622. <dd>
  623. \anchor with-simgrid-include-dir
  624. \addindex __configure__--with-simgrid-include-dir
  625. Similar to the option \ref enable-simgrid "--enable-simgrid" but also
  626. allows to specify the location to the SimGrid include directory.
  627. </dd>
  628. <dt>--with-simgrid-lib-dir</dt>
  629. <dd>
  630. \anchor with-simgrid-lib-dir
  631. \addindex __configure__--with-simgrid-lib-dir
  632. Similar to the option \ref enable-simgrid "--enable-simgrid" but also
  633. allows to specify the location to the SimGrid lib directory.
  634. </dd>
  635. <dt>--with-smpirun=<c>path</c></dt>
  636. <dd>
  637. \anchor with-smpirun
  638. \addindex __configure__--with-smpirun
  639. Use the smpirun at <c>path</c>
  640. </dd>
  641. <dt>--enable-simgrid-mc</dt>
  642. <dd>
  643. \anchor enable-simgrid-mc
  644. \addindex __configure__--enable-simgrid-mc
  645. Enable the Model Checker in simulation of execution in SimGrid, to allow
  646. exploring various execution paths.
  647. </dd>
  648. <dt>--enable-calibration-heuristic</dt>
  649. <dd>
  650. \anchor enable-calibration-heuristic
  651. \addindex __configure__--enable-calibration-heuristic
  652. Allow to set the maximum authorized percentage of deviation
  653. for the history-based calibrator of StarPU. A correct value
  654. of this parameter must be in [0..100]. The default value of
  655. this parameter is 10. Experimental.
  656. </dd>
  657. <dt>--enable-mlr</dt>
  658. <dd>
  659. \anchor enable-mlr
  660. \addindex __configure__--enable-mlr
  661. Allow to enable multiple linear regression models (see \ref PerformanceModelExample)
  662. </dd>
  663. <dt>--enable-mlr-system-blas</dt>
  664. <dd>
  665. \anchor enable-mlr-system-blas
  666. \addindex __configure__--enable-mlr-system-blas
  667. Allow to make multiple linear regression models use the system-provided BLAS for dgels
  668. (see \ref PerformanceModelExample)
  669. </dd>
  670. </dl>
  671. */