Split lines with many copyright years
[gromacs.git] / cmake / gmxManageMPI.cmake
blobd482f13a13c44a840328543f11c0cebfad58e198
2 # This file is part of the GROMACS molecular simulation package.
4 # Copyright (c) 2012,2013,2014,2015,2016 by the GROMACS development team.
5 # Copyright (c) 2019,2020, by the GROMACS development team, led by
6 # Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
7 # and including many others, as listed in the AUTHORS file in the
8 # top-level source directory and at http://www.gromacs.org.
10 # GROMACS is free software; you can redistribute it and/or
11 # modify it under the terms of the GNU Lesser General Public License
12 # as published by the Free Software Foundation; either version 2.1
13 # of the License, or (at your option) any later version.
15 # GROMACS is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18 # Lesser General Public License for more details.
20 # You should have received a copy of the GNU Lesser General Public
21 # License along with GROMACS; if not, see
22 # http://www.gnu.org/licenses, or write to the Free Software Foundation,
23 # Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.
25 # If you want to redistribute modifications to GROMACS, please
26 # consider that scientific software is very special. Version
27 # control is crucial - bugs must be traceable. We will be happy to
28 # consider code for inclusion in the official distribution, but
29 # derived work must not be called official GROMACS. Details are found
30 # in the README & COPYING files - if they are missing, get the
31 # official version at http://www.gromacs.org.
33 # To help us fund GROMACS development, we humbly ask that you cite
34 # the research papers on the package. Check out http://www.gromacs.org.
36 # Manage the MPI setup, assuming that CMAKE_C_COMPILER is an MPI
37 # (wrapper) compiler.
38 if(GMX_MPI)
39   if(GMX_THREAD_MPI)
40     message(STATUS "MPI is not compatible with thread-MPI. Disabling thread-MPI.")
41     set(GMX_THREAD_MPI OFF CACHE BOOL
42         "Build a thread-MPI-based multithreaded version of GROMACS (not compatible with MPI)" FORCE)
43   endif()
45   # Test the CMAKE_C_COMPILER for being an MPI (wrapper) compiler
46   TRY_COMPILE(MPI_FOUND ${CMAKE_BINARY_DIR}
47     "${CMAKE_SOURCE_DIR}/cmake/TestMPI.cpp"
48     COMPILE_DEFINITIONS )
50   # If CMAKE_C_COMPILER is not a MPI wrapper. Try to find MPI using cmake module as fall-back.
51   if(NOT MPI_FOUND)
52       find_package(MPI)
53       if(MPI_C_FOUND)
54           set(MPI_COMPILE_FLAGS ${MPI_C_COMPILE_FLAGS})
55           set(MPI_LINKER_FLAGS ${MPI_C_LINK_FLAGS})
56           include_directories(SYSTEM ${MPI_C_INCLUDE_PATH})
57           list(APPEND GMX_COMMON_LIBRARIES ${MPI_C_LIBRARIES})
58       endif()
59       set(MPI_FOUND ${MPI_C_FOUND})
60   else()
61       # The following defaults are based on FindMPI.cmake in cmake
62       # 3.1.2. (That package does not actually do any detection of the
63       # flags, but if it ever does then we should re-visit how we use
64       # the package.) If we are compiling with an MPI wrapper
65       # compiler, then MPI_FOUND will be set above, and will mean that
66       # none of these cache variables are populated by the package. We
67       # need to do it manually so that test drivers can work using the
68       # standard machinery for CMake + FindMPI.cmake.  Users will need
69       # to set these to suit their MPI setup in order for tests to
70       # work.
72       find_program(MPIEXEC
73           NAMES mpiexec mpirun lamexec srun aprun poe
74           HINTS ${MPI_HOME} $ENV{MPI_HOME}
75           PATH_SUFFIXES bin
76           DOC "Executable for running MPI programs.")
78       set(MPIEXEC_NUMPROC_FLAG "-np" CACHE STRING "Flag used by MPI to specify the number of processes for MPIEXEC; the next option will be the number of processes.")
79       set(MPIEXEC_PREFLAGS     ""    CACHE STRING "These flags will be directly before the executable that is being run by MPIEXEC.")
80       set(MPIEXEC_POSTFLAGS    ""    CACHE STRING "These flags will come after all flags given to MPIEXEC.")
81       set(MPIEXEC_MAX_NUMPROCS "2"   CACHE STRING "Maximum number of processors available to run MPI applications.")
82       mark_as_advanced(MPIEXEC MPIEXEC_NUMPROC_FLAG MPIEXEC_PREFLAGS MPIEXEC_POSTFLAGS MPIEXEC_MAX_NUMPROCS)
83   endif()
85   if(MPI_FOUND)
86     include(gmxTestMPI_IN_PLACE)
87     if (GMX_MPI_IN_PLACE)
88       gmx_test_mpi_in_place(MPI_IN_PLACE_EXISTS)
89     endif()
91     # Find path of the mpi compilers
92     if (${MPI_C_FOUND})
93         get_filename_component(_mpi_c_compiler_path "${MPI_C_COMPILER}" PATH)
94         get_filename_component(_mpiexec_path "${MPIEXEC}" PATH)
95     else()
96         get_filename_component(_cmake_c_compiler_path "${CMAKE_C_COMPILER}" PATH)
97         get_filename_component(_cmake_cxx_compiler_path "${CMAKE_CXX_COMPILER}" PATH)
98     endif()
100     # Test for and warn about unsuitable MPI versions
101     #
102     # Execute the ompi_info binary with the full path of the compiler wrapper
103     # found, otherwise we run the risk of false positives.
104     find_file(MPI_INFO_BIN ompi_info
105               HINTS ${_mpi_c_compiler_path} ${_mpiexec_path}
106                     ${_cmake_c_compiler_path} ${_cmake_cxx_compiler_path}
107               NO_DEFAULT_PATH
108               NO_SYSTEM_ENVIRONMENT_PATH
109               NO_CMAKE_SYSTEM_PATH)
110     if (MPI_INFO_BIN)
111       exec_program(${MPI_INFO_BIN}
112         ARGS -v ompi full
113         OUTPUT_VARIABLE OPENMPI_TYPE
114         RETURN_VALUE OPENMPI_EXEC_RETURN)
115       if(OPENMPI_EXEC_RETURN EQUAL 0)
116         string(REGEX REPLACE ".*Open MPI: \([0-9]+\\.[0-9]*\\.?[0-9]*\).*" "\\1" OPENMPI_VERSION ${OPENMPI_TYPE})
117         if(OPENMPI_VERSION VERSION_LESS "1.4.1")
118           MESSAGE(WARNING
119              "CMake found OpenMPI version ${OPENMPI_VERSION} on your system. "
120              "There are known problems with GROMACS and OpenMPI version < 1.4.1. "
121              "Please consider updating your OpenMPI if your MPI wrapper compilers "
122              "are using the above OpenMPI version.")
123         endif()
124         if(OPENMPI_VERSION VERSION_EQUAL "1.8.6")
125           MESSAGE(WARNING
126              "CMake found OpenMPI version ${OPENMPI_VERSION} on your system. "
127              "This OpenMPI version is known to leak memory with GROMACS,"
128              "please update to a more recent version. ")
129         endif()
130         unset(OPENMPI_VERSION)
131         unset(OPENMPI_TYPE)
132         unset(OPENMPI_EXEC_RETURN)
133       endif()
134     endif()
135     unset(MPI_INFO_BIN CACHE)
137     # Execute the mpiname binary with the full path of the compiler wrapper
138     # found, otherwise we run the risk of false positives.
139     find_file(MPINAME_BIN mpiname
140               HINTS ${_mpi_c_compiler_path}
141                     ${_cmake_c_compiler_path} ${_cmake_cxx_compiler_path}
142               NO_DEFAULT_PATH
143               NO_SYSTEM_ENVIRONMENT_PATH
144               NO_CMAKE_SYSTEM_PATH)
145     if (MPINAME_BIN)
146       exec_program(${MPINAME_BIN}
147         ARGS -n -v
148         OUTPUT_VARIABLE MVAPICH2_TYPE
149         RETURN_VALUE MVAPICH2_EXEC_RETURN)
150       if(MVAPICH2_EXEC_RETURN EQUAL 0)
151         string(REGEX MATCH "MVAPICH2" MVAPICH2_NAME ${MVAPICH2_TYPE})
152         # Want to check for MVAPICH2 in case some other library supplies mpiname
153         string(REGEX REPLACE "MVAPICH2 \([0-9]+\\.[0-9]*[a-z]?\\.?[0-9]*\)" "\\1" MVAPICH2_VERSION ${MVAPICH2_TYPE})
154         if(${MVAPICH2_NAME} STREQUAL "MVAPICH2" AND MVAPICH2_VERSION VERSION_LESS "1.5")
155           # This test works correctly even with 1.5a1
156           MESSAGE(WARNING
157              "CMake found MVAPICH2 version ${MVAPICH2_VERSION} on your system. "
158              "There are known problems with GROMACS and MVAPICH2 version < 1.5. "
159              "Please consider updating your MVAPICH2 if your MPI wrapper compilers "
160              "are using the above MVAPICH2 version.")
161        endif()
162        unset(MVAPICH2_VERSION)
163        unset(MVAPICH2_NAME)
164        unset(MVAPICH2_TYPE)
165        unset(MVAPICH2_EXEC_RETURN)
166       endif()
167     endif()
168     unset(MPINAME_BIN CACHE)
169   else()
170       message(FATAL_ERROR
171         "MPI support requested, but no MPI compiler found. Either set the "
172         "C-compiler (CMAKE_C_COMPILER) to the MPI compiler (often called mpicc), "
173         "or set the variables reported missing for MPI_C above.")
174   endif()
176   set(GMX_LIB_MPI 1)
177 endif()