510_configure_options.doxy 22 KB

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