Update instructions in containers.rst
[gromacs.git] / src / config.h.cmakein
blob5991b0c71124912cf9a68553ee7e90b44ca9d6a6
1 /*
2  * This file is part of the GROMACS molecular simulation package.
3  *
4  * Copyright (c) 2009,2010,2011,2012,2013 by the GROMACS development team.
5  * Copyright (c) 2014,2015,2016,2017,2018 by the GROMACS development team.
6  * Copyright (c) 2019,2020, by the GROMACS development team, led by
7  * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
8  * and including many others, as listed in the AUTHORS file in the
9  * top-level source directory and at http://www.gromacs.org.
10  *
11  * GROMACS is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU Lesser General Public License
13  * as published by the Free Software Foundation; either version 2.1
14  * of the License, or (at your option) any later version.
15  *
16  * GROMACS is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
19  * Lesser General Public License for more details.
20  *
21  * You should have received a copy of the GNU Lesser General Public
22  * License along with GROMACS; if not, see
23  * http://www.gnu.org/licenses, or write to the Free Software Foundation,
24  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.
25  *
26  * If you want to redistribute modifications to GROMACS, please
27  * consider that scientific software is very special. Version
28  * control is crucial - bugs must be traceable. We will be happy to
29  * consider code for inclusion in the official distribution, but
30  * derived work must not be called official GROMACS. Details are found
31  * in the README & COPYING files - if they are missing, get the
32  * official version at http://www.gromacs.org.
33  *
34  * To help us fund GROMACS development, we humbly ask that you cite
35  * the research papers on the package. Check out http://www.gromacs.org.
36  */
37 /*! \libinternal \file
38  * \brief
39  * Include file for configuration macros from the build system.
40  *
41  * This header is not installed, so headers must not reference macros defined
42  * here.
43  *
44  * \inlibraryapi
45  */
46 #ifndef GMX_CONFIG_H
47 #define GMX_CONFIG_H
49 /* TODO: For now, disable Doxygen warnings from here */
50 /*! \cond */
52 /* Work around broken calloc() */
53 #cmakedefine01 GMX_BROKEN_CALLOC
55 /* Do not optimize FFTW setups (not needed with SSE FFT kernels) */
56 #cmakedefine01 GMX_DISABLE_FFTW_MEASURE
58 /* Use FFTW3 FFT library */
59 #cmakedefine01 GMX_FFT_FFTW3
61 /* Use the ARM Performance library with FFTW3 compatibility */
62 #cmakedefine01 GMX_FFT_ARMPL_FFTW3
64 /* Use MKL FFT library */
65 #cmakedefine01 GMX_FFT_MKL
67 /* Use built in fftpack FFT library */
68 #cmakedefine01 GMX_FFT_FFTPACK
70 /* Target platform is x86 or x86_64 */
71 #cmakedefine01 GMX_TARGET_X86
73 /** Define if we are building natively on Windows */
74 #cmakedefine01 GMX_NATIVE_WINDOWS
76 /** Define if we are building for Cygwin */
77 #cmakedefine01 GMX_CYGWIN
79 /* SSE2 was selected for SIMD instruction set level */
80 #cmakedefine01 GMX_SIMD_X86_SSE2
82 /* SSE4.1 was selected as SIMD instructions */
83 #cmakedefine01 GMX_SIMD_X86_SSE4_1
85 /* AVX 128-bit FMA was selected as SIMD instructions */
86 #cmakedefine01 GMX_SIMD_X86_AVX_128_FMA
88 /* AVX 256-bit was selected as SIMD instructions */
89 #cmakedefine01 GMX_SIMD_X86_AVX_256
91 /* AVX2 256-bit SIMD instruction set level was selected */
92 #cmakedefine01 GMX_SIMD_X86_AVX2_256
94 /* AVX2 128-bit SIMD instruction set level was selected */
95 #cmakedefine01 GMX_SIMD_X86_AVX2_128
97 /* MIC (Xeon Phi) SIMD instruction set level was selected */
98 #cmakedefine01 GMX_SIMD_X86_MIC
100 /* AVX-512F foundation level instruction SIMD */
101 #cmakedefine01 GMX_SIMD_X86_AVX_512
103 /* AVX-512ER foundation level instruction SIMD */
104 #cmakedefine01 GMX_SIMD_X86_AVX_512_KNL
106 /* 32-bit ARM NEON SIMD instruction set level was selected */
107 #cmakedefine01 GMX_SIMD_ARM_NEON
109 /* ARM (AArch64) NEON Advanced SIMD instruction set level was selected */
110 #cmakedefine01 GMX_SIMD_ARM_NEON_ASIMD
112 /* ARM (SVE) Scalable Vector extensions */
113 #cmakedefine01 GMX_SIMD_ARM_SVE
115 /* SVE vector length */
116 #define GMX_SIMD_ARM_SVE_LENGTH_VALUE @GMX_SIMD_ARM_SVE_LENGTH_VALUE@
118 /* IBM VMX was selected as SIMD instructions (Power 6 and later) */
119 #cmakedefine01 GMX_SIMD_IBM_VMX
121 /* IBM VSX was selected as SIMD instructions (Power 7 and later) */
122 #cmakedefine01 GMX_SIMD_IBM_VSX
124 /* Fujitsu Sparc64 HPC-ACE SIMD acceleration */
125 #cmakedefine01 GMX_SIMD_SPARC64_HPC_ACE
127 /* Reference SIMD implementation for testing */
128 #cmakedefine01 GMX_SIMD_REFERENCE
130 /* String for SIMD instruction choice (for writing to log files and stdout) */
131 #define GMX_SIMD_STRING "@GMX_SIMD_ACTIVE@"
133 /* Calling convention string (if any) for routines with SIMD variable args */
134 #define gmx_simdcall @GMX_SIMD_CALLING_CONVENTION@
136 /* Target mantissa accuracy for SIMD single precision math */
137 #define GMX_SIMD_ACCURACY_BITS_SINGLE @GMX_SIMD_ACCURACY_BITS_SINGLE@
139 /* Target mantissa accuracy for SIMD double precision math */
140 #define GMX_SIMD_ACCURACY_BITS_DOUBLE @GMX_SIMD_ACCURACY_BITS_DOUBLE@
142 /* Enable code that requires AVX-512 instruction support, without GMX_SIMD=AVX_512 */
143 #cmakedefine01 SIMD_AVX_512_CXX_SUPPORTED
145 /* Whether NBNXM and other SIMD kernels should be compiled */
146 #cmakedefine01 GMX_USE_SIMD_KERNELS
148 /* Whether a double-precision configuration may target accuracy equivalent to single precision */
149 #cmakedefine01 GMX_RELAXED_DOUBLE_PRECISION
151 /* Integer byte order is big endian. */
152 #cmakedefine01 GMX_INTEGER_BIG_ENDIAN
154 /* Use our own instead of system XDR libraries */
155 #cmakedefine01 GMX_INTERNAL_XDR
157 /* Compile to use TNG library */
158 #cmakedefine01 GMX_USE_TNG
160 /* Add support for tracing using Extrae */
161 #cmakedefine01 HAVE_EXTRAE
163 /* Use MPI (with mpicc) for parallelization */
164 #cmakedefine01 GMX_LIB_MPI
166 /* Use threads_mpi for parallelization */
167 #cmakedefine01 GMX_THREAD_MPI
169 /* Make a parallel version of GROMACS using message passing
170    (MPI or thread_mpi) */
171 #define GMX_MPI (GMX_LIB_MPI || GMX_THREAD_MPI)
173 /* MPI_IN_PLACE exists for collective operations */
174 #cmakedefine01 MPI_IN_PLACE_EXISTS
176 /* Use OpenMP multithreading */
177 #cmakedefine01 GMX_OPENMP
179 /* Use the Portable Hardware Locality package (hwloc) */
180 #cmakedefine01 GMX_USE_HWLOC
182 /* Library version found for hwloc during configuration time */
183 #define GMX_HWLOC_API_VERSION @GMX_HWLOC_API_VERSION@
185 /* Can and should use nice(3) to set priority */
186 #cmakedefine01 GMX_USE_NICE
188 /* Maximum number of OpenMP threads supported */
189 #define GMX_OPENMP_MAX_THREADS @GMX_OPENMP_MAX_THREADS@
191 /* Use if we cannot rename checkpoints */
192 #cmakedefine01 GMX_NO_RENAME
194 /* Use sub-counters */
195 #cmakedefine01 GMX_CYCLE_SUBCOUNTERS
197 /* Compile with plugin support */
198 #cmakedefine01 GMX_USE_PLUGINS
200 /* Fallback path for VMD plug-ins */
201 #define GMX_VMD_PLUGIN_PATH "@GMX_VMD_PLUGIN_PATH@"
203 /* Default path for DSSP program */
204 #define GMX_DSSP_PROGRAM_PATH "@GMX_DSSP_PROGRAM_PATH@"
206 /* Define when pthreads are used */
207 #cmakedefine THREAD_PTHREADS
209 /* Define when Windows threads are used */
210 #cmakedefine THREAD_WINDOWS
212 /* Define for busy wait option  */
213 /* See gmxpre-config.h.cmakein for explanation for the #ifndef */
214 #ifndef TMPI_WAIT_FOR_NO_ONE
215 #cmakedefine01 TMPI_WAIT_FOR_NO_ONE
216 #endif
218 /* Define for copy buffer option */
219 #cmakedefine TMPI_COPY_BUFFER
221 /* Define for tmpi warnings option */
222 #cmakedefine TMPI_WARNINGS
224 /* Define for profiling option */
225 #cmakedefine TMPI_PROFILE
227 /* Define for Linux pthread_setaffinity_np */
228 #cmakedefine HAVE_PTHREAD_SETAFFINITY
230 /* Define for X-Windows */
231 #cmakedefine01 GMX_X11
233 /* Enable x86 gcc inline assembly */
234 #cmakedefine01 GMX_X86_GCC_INLINE_ASM
236 /* Define if any type of GPU acceleration is compiled */
237 #cmakedefine01 GMX_GPU
239 /* Define if CUDA GPU acceleration is compiled */
240 #cmakedefine01 GMX_GPU_CUDA
242 /* Define if OpenCL GPU acceleration is compiled */
243 #cmakedefine01 GMX_GPU_OPENCL
245 /* Define if SYCL GPU acceleration is compiled */
246 #cmakedefine01 GMX_GPU_SYCL
248 /* Use a single compilation unit when compiling the CUDA (non-bonded) kernels.  */
249 #cmakedefine01 GMX_CUDA_NB_SINGLE_COMPILATION_UNIT
251 /* Cluster size used by nonbonded OpenCL kernel. Should be 8 for NVIDIA/AMD and 4 for Intel */
252 #define GMX_OPENCL_NB_CLUSTER_SIZE @GMX_OPENCL_NB_CLUSTER_SIZE@
254 /* Define constants for build types (starting at 1 to make sure undefined values don't match) */
255 #define CMAKE_BUILD_TYPE_DEBUG 1
256 #define CMAKE_BUILD_TYPE_RELEASE 2
257 #define CMAKE_BUILD_TYPE_RELWITHDEBINFO 3
258 #define CMAKE_BUILD_TYPE_MINSIZEREL 4
259 #define CMAKE_BUILD_TYPE_REFERENCE 5
260 #define CMAKE_BUILD_TYPE_RELWITHASSERT 6
261 #define CMAKE_BUILD_TYPE_PROFILE 7
262 #define CMAKE_BUILD_TYPE_TSAN 8
263 #define CMAKE_BUILD_TYPE_ASAN 9
264 #define CMAKE_BUILD_TYPE_MSAN 10
265 #define CMAKE_BUILD_TYPE_UBSAN 11
266 #cmakedefine CMAKE_BUILD_TYPE CMAKE_BUILD_TYPE_@CMAKE_BUILD_TYPE_UPPER@
268 /* Define relative path to OpenCL kernels */
269 #define GMX_INSTALL_OCLDIR "@GMX_INSTALL_OCLDIR@"
271 /* Minimum required OpenCL version support (both API and device) - split into integer components for convenience */
272 #define REQUIRED_OPENCL_MIN_VERSION_MAJOR @REQUIRED_OPENCL_MIN_VERSION_MAJOR@
273 #define REQUIRED_OPENCL_MIN_VERSION_MINOR @REQUIRED_OPENCL_MIN_VERSION_MINOR@
275 /* Define to 1 if fseeko (and presumably ftello) exists and is declared. */
276 #cmakedefine01 HAVE_FSEEKO
278 /* Define to 1 if _fseeki64 (and presumably _fseeki64) exists and is declared. */
279 #cmakedefine01 HAVE__FSEEKI64
281 /* Have io.h (windows)*/
282 #cmakedefine01 HAVE_IO_H
284 /* Define to 1 if you have the posix_memalign() function. */
285 #cmakedefine01 HAVE_POSIX_MEMALIGN
287 /* Define to 1 if you have the memalign() function. */
288 #cmakedefine01 HAVE_MEMALIGN
290 /* Define to 1 if you have the MSVC _aligned_malloc() function. */
291 #cmakedefine01 HAVE__ALIGNED_MALLOC
293 /* Define to 1 if you have the clock_gettime() function. */
294 #cmakedefine01 HAVE_CLOCK_GETTIME
296 /* Define to 1 if you have the gettimeofday() function. */
297 #cmakedefine01 HAVE_GETTIMEOFDAY
299 /* Define to 1 if you have the rdtscp instruction (ie essentially all x86 still in use. */
300 #cmakedefine01 GMX_USE_RDTSCP
302 /* Define to 1 if you have the fsync() function. */
303 #cmakedefine01 HAVE_FSYNC
305 /* Define to 1 if you have the Windows _commit() function. */
306 #cmakedefine01 HAVE__COMMIT
308 /* Define to 1 if you have the fileno() function. */
309 #cmakedefine01 HAVE_FILENO
311 /* Define to 1 if you have the _fileno() function. */
312 #cmakedefine01 HAVE__FILENO
314 /* Define to 1 if you have the sigaction() function. */
315 #cmakedefine01 HAVE_SIGACTION
317 /* Define for the GNU __builtin_clz() function. */
318 #cmakedefine01 HAVE_BUILTIN_CLZ
320 /* Define for the GNU __builtin_clzll() function. */
321 #cmakedefine01 HAVE_BUILTIN_CLZLL
323 /* Define for the MSVC _BitScanReverse() function. */
324 #cmakedefine01 HAVE_BITSCANREVERSE
326 /* Define for the MSVC _BitScanReverse64() function. */
327 #cmakedefine01 HAVE_BITSCANREVERSE64
329 /* Define for the IBM xlc++ __cntlz4() function. */
330 #cmakedefine01 HAVE_CNTLZ4
332 /* Define for the IBM xlc++ __cntlz8() function. */
333 #cmakedefine01 HAVE_CNTLZ8
335 /* Define to 1 if yo have the <unistd.h> header file. */
336 #cmakedefine HAVE_UNISTD_H
337 #  ifdef __APPLE__
338 // Mac OS 13.x has a bug where dispatch.h generates an error for OpenCL builds if
339 // HAVE_UNISTD_H is merely defined, but not set to 1. Since unistd.h should always
340 // be available on this platform we simply undefine and redefine it to 1 for now
341 #    undef  HAVE_UNISTD_H
342 #    define HAVE_UNISTD_H 1
343 #endif
345 /* Define to 1 if yo have the <pwd.h> header file. */
346 #cmakedefine01 HAVE_PWD_H
348 /* Define to 1 if yo have the <dirent.h> header file. */
349 #cmakedefine01 HAVE_DIRENT_H
351 /* Define to 1 if you have the <sys/time.h> header file. */
352 #cmakedefine HAVE_SYS_TIME_H
354 /* Define to 1 if you have the <sched.h> header */
355 #cmakedefine HAVE_SCHED_H
357 /* Define to 1 if mm_malloc.h is present, otherwise 0 */
358 #cmakedefine01 HAVE_MM_MALLOC_H
360 /* Define to 1 if malloc.h is present, otherwise 0 */
361 #cmakedefine01 HAVE_MALLOC_H
363 /* Define to 1 if xmmintrin.h is present, otherwise 0 */
364 #cmakedefine01 HAVE_XMMINTRIN_H
366 /* Define to 1 if you have the sysconf() function */
367 #cmakedefine HAVE_SYSCONF
369 /* Define to 1 if you have the all the affinity functions in sched.h */
370 #cmakedefine01 HAVE_SCHED_AFFINITY
372 /* Define to 1 if _mm_malloc() is present in either mm_malloc.h,
373  * malloc.h or xmmintrin.h, and 0 otherwise. Note that you need to
374  * conditionally include the three headers too before using _mm_malloc().
375  */
376 #cmakedefine01 HAVE__MM_MALLOC
378 /* Define if SIGUSR1 is present */
379 #cmakedefine01 HAVE_SIGUSR1
381 /* Enable gromacs quotes */
382 #cmakedefine01 GMX_COOL_QUOTES
384 /* default name mangling maybe wrong on exotic plattforms */
385 #define F77_FUNC(name,NAME) name ## _
387 /* Define if we have pipes */
388 #cmakedefine01 HAVE_PIPES
390 /* Define if we have feenableexcept */
391 #cmakedefine01 HAVE_FEENABLEEXCEPT
393 /* Define if we have fedisableexcept */
394 #cmakedefine01 HAVE_FEDISABLEEXCEPT
396 /* Define if we have lmfit support */
397 #cmakedefine01 HAVE_LMFIT
399 /* Build using clang analyzer */
400 #cmakedefine01 GMX_CLANG_ANALYZER
402 /* Use MiMiC QM/MM interface */
403 #cmakedefine01 GMX_MIMIC
405 /* Use Interactive Molecular Dynamics */
406 #cmakedefine01 GMX_IMD
408 /*! \endcond */
410 #endif