From f542f98d72c2cd651a0eae4d092c12239976db3f Mon Sep 17 00:00:00 2001 From: Axel Huebl Date: Wed, 9 Sep 2020 08:31:53 -0700 Subject: [PATCH] Docs: MPI_THREAD_MULTIPLE (#1355) ## Summary Add GNUmake and CMake docs about control of `MPI_THREAD_MULTIPLE`. ## Additional background ## Checklist The proposed changes: - [ ] fix a bug or incorrect behavior in AMReX - [ ] add new capabilities to AMReX - [ ] changes answers in the test suite to more than roundoff level - [ ] are likely to significantly affect the results of downstream AMReX users - [x] are described in the proposed changes to the AMReX documentation, if appropriate --- Docs/sphinx_documentation/source/BuildingAMReX.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Docs/sphinx_documentation/source/BuildingAMReX.rst b/Docs/sphinx_documentation/source/BuildingAMReX.rst index 7b3bc469112..4c6df295d20 100644 --- a/Docs/sphinx_documentation/source/BuildingAMReX.rst +++ b/Docs/sphinx_documentation/source/BuildingAMReX.rst @@ -101,6 +101,8 @@ to FALSE. The meaning of these variables should be obvious. When ``DEBUG=TRUE``, aggressive compiler optimization flags are turned off and assertions in source code are turned on. For production runs, ``DEBUG`` should be set to FALSE. +An advanced variable, ``MPI_THREAD_MULTIPLE``, can be set to TRUE to initialize +MPI with support for concurrent MPI calls from multiple threads. Variables ``USE_CUDA``, ``USE_HIP`` and ``USE_DPCPP`` are used for targeting Nvidia, AMD and Intel GPUs, respectively. At most one of @@ -477,6 +479,8 @@ below. +------------------------------+-------------------------------------------------+-------------+-----------------+ | ENABLE_MEM_PROFILE | Build with memory-profiling support | NO | YES, NO | +------------------------------+-------------------------------------------------+-------------+-----------------+ + | ENABLE_MPI_THREAD_MULTIPLE | Concurrent MPI calls from multiple threads | NO | YES, NO | + +------------------------------+-------------------------------------------------+-------------+-----------------+ | ENABLE_PROFPARSER | Build with profile parser support | NO | YES, NO | +------------------------------+-------------------------------------------------+-------------+-----------------+ | ENABLE_FPE | Build with Floating Point Exceptions checks | NO | YES, NO |