712b93da878e5d4f861cc93093fa85be05ec46d8
[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
28 Unification of several CUDA and OpenCL environment variables
29 """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""
30
31 The environment variables that had exactly the same meaning in OpenCL and CUDA were unified:
32
33 * GMX_CUDA_NB_ANA_EWALD and GMX_OCL_NB_ANA_EWALD into GMX_GPU_NB_ANA_EWALD
34 * GMX_CUDA_NB_TAB_EWALD and GMX_OCL_NB_TAB_EWALD into GMX_GPU_NB_TAB_EWALD
35 * GMX_CUDA_NB_EWALD_TWINCUT and GMX_OCL_NB_EWALD_TWINCUT into GMX_GPU_NB_EWALD_TWINCUT