Simplified uniform GPU selection in CMake
[alexxy/gromacs.git] / docs / release-notes / 2021 / major / miscellaneous.rst
1 Miscellaneous
2 ^^^^^^^^^^^^^
3
4 .. Note to developers!
5    Please use """"""" to underline the individual entries for fixed issues in the subfolders,
6    otherwise the formatting on the webpage is messed up.
7    Also, please use the syntax :issue:`number` to reference issues on GitLab, without the
8    a space between the colon and number!
9
10 Uniform and manual CMake GPU-support configuration
11 """"""""""""""""""""""""""""""""""""""""""""""""""
12 The GPU accelerations setup has been changed to be uniform for CUDA and OpenCL. Either
13 option is now enabled by setting GMX_GPU to CUDA or OpenCL in the CMake configuration.
14 To simplify the CMake code, we have also moved away from automated option selection
15 based on the build host. In particular, this means that CUDA will not be enabled unless
16 the GMX_GPU option is explicitly enabled, and CMake will no longer perform the extra
17 steps of trying to detect hardware and propose to install CUDA if hardware is available.
18 Apart from the simplification, this should also make it easier to handle multiple
19 different accelerator APIs targeting e.g. NVIDIA hardware.
20
21 Configuration-time trivalue options changed from autodetection to boolean on/off
22 """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
23 To simplify the CMake configuration and avoid having multiple settings that
24 change outside of the users direct control we have removed the support for
25 automatically setting booleans. GMX_BUILD_HELP and GMX_HWLOC are now
26 disabled by default, while GMX_LOAD_PLUGINS is enabled by default.
27