510_configure_options.doxy 22 KB

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