1 dnl SPDX-License-Identifier: LGPL-2.1-only
3 dnl Copyright (C) 2021 EfficiOS, Inc.
5 dnl Process this file with autoconf to produce a configure script.
7 # Project version information
8 m4_define([urcu_version_major], [0])
9 m4_define([urcu_version_minor], [12])
10 m4_define([urcu_version_patch], [0])
11 m4_define([urcu_version_dev_stage], [])
12 m4_define([urcu_version], urcu_version_major[.]urcu_version_minor[.]urcu_version_patch[]urcu_version_dev_stage)
14 # Library version information of "liburcu"
15 # Following the numbering scheme proposed by libtool for the library version
16 # http://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html
17 m4_define([urcu_lib_version_current], [7])
18 m4_define([urcu_lib_version_revision], [0])
19 m4_define([urcu_lib_version_age], [1])
20 m4_define([urcu_lib_version], urcu_lib_version_current[:]urcu_lib_version_revision[:]urcu_lib_version_age)
24 ## Autoconf base setup ##
28 AC_INIT([userspace-rcu],[urcu_version],[mathieu dot desnoyers at efficios dot com],[],[http://liburcu.org/])
30 AC_CONFIG_HEADERS([include/config.h include/urcu/config.h])
31 AC_CONFIG_AUX_DIR([config])
32 AC_CONFIG_MACRO_DIR([m4])
39 ## Automake base setup ##
42 AM_INIT_AUTOMAKE([1.12 foreign dist-bzip2 no-dist-gzip nostdinc -Wall -Wno-portability -Werror])
43 AM_MAINTAINER_MODE([enable])
45 # Enable silent rules by default
46 AM_SILENT_RULES([yes])
50 ## OS and Arch specific defaults ##
54 [*-cygwin*], [LT_NO_UNDEFINED="-no-undefined"]
59 ## C compiler checks ##
62 # Choose the C compiler
64 # AC_PROG_CC_STDC was merged in AC_PROG_CC in autoconf 2.70
65 m4_version_prereq([2.70], [], [AC_PROG_CC_STDC])
67 # Make sure the C compiler supports C99
68 AS_IF([test "$ac_cv_prog_cc_c99" = "no"], [AC_MSG_ERROR([The compiler does not support C99])])
70 # Enable available system extensions and LFS support
71 AC_USE_SYSTEM_EXTENSIONS
74 # Make sure the C compiler supports __attribute__
76 AS_IF([test "x$ax_cv___attribute__" != "xyes"],
77 [AC_MSG_ERROR([The compiler does not support __attribute__ extensions])])
79 # Make sure we have pthread support
80 AX_PTHREAD([], [AC_MSG_ERROR([Could not configure pthread support])])
82 # Make sure the C compiler supports weak symbols
84 AS_IF([test "x$ax_cv_sys_weak_alias" = "xno"],
85 [AC_MSG_ERROR([Your platform doesn't support weak symbols.])])
87 # Checks for typedefs, structures, and compiler characteristics.
114 ## Programs checks ##
120 AC_CHECK_PROGS(NPROC, [nproc gnproc])
121 AC_CHECK_PROG(GETCONF, [getconf])
122 AS_IF([test "x$NPROC" != "x"],
124 [AS_IF([test "x$GETCONF" != "x"],
125 [NPROC_CMD="$GETCONF _NPROCESSORS_ONLN"],
129 AC_SUBST([NPROC_CMD], [$NPROC_CMD])
131 # Initialize and configure libtool
139 # Checks for library functions.
157 # AC_FUNC_MALLOC causes problems when cross-compiling.
160 # Search for clock_gettime() in -lrt
161 AC_SEARCH_LIBS([clock_gettime], [rt], [
162 AC_DEFINE([CONFIG_RCU_HAVE_CLOCK_GETTIME], [1], [clock_gettime() is detected.])
167 ## Optionnal features selection ##
170 # Allow to fallback to FIXME if the membarrier syscall is unavailable on the
171 # running kernel, when disabled, abort if the syscall is unavailable. Applies
172 # to default and bulletproof flavors.
174 AE_FEATURE_DEFAULT_ENABLE
175 AE_FEATURE([sys-membarrier-fallback], [Abort if sys-membarrier is needed but not available rather than using a fallback.])
177 # Use compiler Thread Local Storage, when disabled use pthread_getspecific() to emulate TLS.
179 AE_FEATURE_DEFAULT_ENABLE
180 AE_FEATURE([compiler-tls], [Use pthread_getspecific() to emulate Thread Local Storage (TLS) variables.])
182 # smp-support configure option
184 AE_FEATURE_DEFAULT_ENABLE
185 AE_FEATURE([smp-support], [Disable SMP support. Warning: only use this on uniprocessor systems.])
187 # RCU debugging option
188 # Disabled by default
189 AE_FEATURE_DEFAULT_DISABLE
190 AE_FEATURE([rcu-debug], [Enable internal debugging self-checks. Introduces a performance penalty.])
192 # rculfhash iterator debugging
193 # Disabled by default
194 AE_FEATURE_DEFAULT_DISABLE
195 AE_FEATURE([cds-lfht-iter-debug], [Enable extra debugging checks for lock-free hash table iterator traversal. Alters the rculfhash ABI. Make sure to compile both library and application with matching configuration.])
199 ## Set defines for optional features conditionnals in the source code ##
202 AE_IF_FEATURE_DISABLED([sys-membarrier-fallback], [
203 AC_DEFINE([CONFIG_RCU_FORCE_SYS_MEMBARRIER], [1], [Require the operating system to support the membarrier system call for default and bulletproof flavors.])
206 AE_IF_FEATURE_ENABLED([compiler-tls], [
207 AC_DEFINE([CONFIG_RCU_TLS], [1], [Use compiler provided Thread Local Storage.])
210 AE_IF_FEATURE_ENABLED([smp-support], [
211 AC_DEFINE([CONFIG_RCU_SMP], [1], [Enable SMP support. With SMP support enabled, uniprocessors are also supported. With SMP support disabled, UP systems work fine, but the behavior of SMP systems is undefined.])
214 AE_IF_FEATURE_ENABLED([rcu-debug], [
215 AC_DEFINE([CONFIG_RCU_DEBUG], [1], [Enable internal debugging self-checks. Introduces a performance penalty.])
218 AE_IF_FEATURE_ENABLED([cds-lfht-iter-debug], [
219 AC_DEFINE([CONFIG_CDS_LFHT_ITER_DEBUG], [1], [Enable extra debugging checks for lock-free hash table iterator traversal. Alters the rculfhash ABI. Make sure to compile both library and application with matching configuration.])
223 # From the sched_setaffinity(2)'s man page:
225 # The CPU affinity system calls were introduced in Linux kernel 2.5.8.
226 # The library interfaces were introduced in glibc 2.3. Initially, the
227 # glibc interfaces included a cpusetsize argument. In glibc 2.3.3,
228 # the cpuset size argument was removed, but this argument was
229 # restored in glibc 2.3.4.
232 # In addition to that, some vendors ported the system call to 2.4
235 # Furthermore, when the function first appeared, the MASK argument was
236 # an unsigned long pointer, while later it was made into a cpu_set_t
237 # pointer. Systems that have the cpu_set_t version also should have
238 # the CPU_ZERO, CPU_SET, etc. macros.
240 # All this mess means we have to cater for at least 3 different
241 # sched_setaffinity prototypes:
244 # int sched_setaffinity (pid_t pid, unsigned int len, unsigned long *mask);
245 # int sched_setaffinity (pid_t __pid, size_t __cpusetsize, const cpu_set_t *__cpuset);
246 # int sched_setaffinity (pid_t __pid, const cpu_set_t *__mask);
249 AC_CHECK_TYPES([cpu_set_t],
250 [have_cpu_set_t="yes"],
251 [have_cpu_set_t="no"],
252 [#include <sched.h>])
254 # Confirm that we have CPU_ZERO, and it actually works.
255 AC_MSG_CHECKING([whether CPU_ZERO works])
256 AH_TEMPLATE([HAVE_CPU_ZERO], [Defined to 1 if we have CPU_ZERO and it works])
257 AC_COMPILE_IFELSE([AC_LANG_SOURCE([[
261 cpu_set_t foo; CPU_ZERO(&foo);
266 AC_DEFINE(HAVE_CPU_ZERO, 1)
272 # Confirm that we have CPU_SET, and it actually works.
273 AC_MSG_CHECKING([whether CPU_SET works])
274 AH_TEMPLATE([HAVE_CPU_SET], [Defined to 1 if we have CPU_SET and it works])
275 AC_COMPILE_IFELSE([AC_LANG_SOURCE([[
279 cpu_set_t foo; CPU_SET(0, &foo);
284 AC_DEFINE(HAVE_CPU_SET, 1)
290 # First check if the function is available at all.
291 AC_CHECK_FUNCS([sched_setaffinity],[
292 # Okay, we have it. Check if also have cpu_set_t. If we don't,
293 # then we have the first version using unsigned long, and no
294 # CPU_ZERO, etc. macros. If we do have cpu_set_t, we may have the
295 # version with 2 or 3 arguments. In that case, CPU_ZERO, etc.,
296 # should also be present, but we confirm nonetheless.
298 AS_IF([test "x$have_cpu_set_t" = "xyes"], [
300 # Check how many arguments does sched_setaffinity take.
302 AC_MSG_CHECKING([how many arguments sched_setaffinity takes])
303 AC_COMPILE_IFELSE([AC_LANG_SOURCE([[
308 sched_setaffinity(0, sizeof (foo), &foo);
313 [sched_set_affinity_args=3],
314 [sched_set_affinity_args=2])
315 AC_DEFINE_UNQUOTED(SCHED_SETAFFINITY_ARGS,
316 $sched_set_affinity_args,
317 [Defined to sched_setaffinity's number of arguments.])
318 AC_MSG_RESULT([$sched_set_affinity_args])
320 # No cpu_set_t, always 3 args.
321 AC_DEFINE(SCHED_SETAFFINITY_ARGS, 3)
327 ## Set automake variables for optional feature conditionnals in Makefile.am ##
330 # Building the examples requires the shared libraries to be enabled
331 AM_CONDITIONAL([ENABLE_EXAMPLES], AE_IS_FEATURE_ENABLED([shared]))
335 ## Substitute variables for use in Makefile.am ##
338 # Library versions for libtool
339 AC_SUBST([URCU_LIBRARY_VERSION], [urcu_lib_version])
341 AC_SUBST(LT_NO_UNDEFINED)
343 AM_CPPFLAGS="-include config.h"
344 AC_SUBST(AM_CPPFLAGS)
346 AM_CFLAGS="-Wall -Wextra -Wno-unused-parameter $PTHREAD_CFLAGS"
352 doc/examples/Makefile
356 tests/common/Makefile
358 tests/benchmark/Makefile
359 tests/regression/Makefile
366 src/liburcu-signal.pc
369 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_perf_global.tap], [chmod +x tests/regression/rcutorture_urcu_bp_perf_global.tap])
370 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_perf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_bp_perf_percpu.tap])
371 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_perf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_bp_perf_perthread.tap])
372 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_rperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_bp_rperf_global.tap])
373 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_rperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_bp_rperf_percpu.tap])
374 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_rperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_bp_rperf_perthread.tap])
375 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_stress_global.tap], [chmod +x tests/regression/rcutorture_urcu_bp_stress_global.tap])
376 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_stress_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_bp_stress_percpu.tap])
377 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_stress_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_bp_stress_perthread.tap])
378 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_uperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_bp_uperf_global.tap])
379 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_uperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_bp_uperf_percpu.tap])
380 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_bp_uperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_bp_uperf_perthread.tap])
381 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_perf_global.tap], [chmod +x tests/regression/rcutorture_urcu_mb_perf_global.tap])
382 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_perf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_mb_perf_percpu.tap])
383 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_perf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_mb_perf_perthread.tap])
384 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_rperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_mb_rperf_global.tap])
385 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_rperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_mb_rperf_percpu.tap])
386 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_rperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_mb_rperf_perthread.tap])
387 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_stress_global.tap], [chmod +x tests/regression/rcutorture_urcu_mb_stress_global.tap])
388 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_stress_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_mb_stress_percpu.tap])
389 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_stress_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_mb_stress_perthread.tap])
390 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_uperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_mb_uperf_global.tap])
391 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_uperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_mb_uperf_percpu.tap])
392 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_mb_uperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_mb_uperf_perthread.tap])
393 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_perf_global.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_perf_global.tap])
394 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_perf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_perf_percpu.tap])
395 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_perf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_perf_perthread.tap])
396 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_rperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_rperf_global.tap])
397 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_rperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_rperf_percpu.tap])
398 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_rperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_rperf_perthread.tap])
399 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_stress_global.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_stress_global.tap])
400 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_stress_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_stress_percpu.tap])
401 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_stress_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_stress_perthread.tap])
402 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_uperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_uperf_global.tap])
403 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_uperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_uperf_percpu.tap])
404 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_membarrier_uperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_membarrier_uperf_perthread.tap])
405 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_perf_global.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_perf_global.tap])
406 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_perf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_perf_percpu.tap])
407 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_perf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_perf_perthread.tap])
408 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_rperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_rperf_global.tap])
409 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_rperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_rperf_percpu.tap])
410 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_rperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_rperf_perthread.tap])
411 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_stress_global.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_stress_global.tap])
412 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_stress_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_stress_percpu.tap])
413 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_stress_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_stress_perthread.tap])
414 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_uperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_uperf_global.tap])
415 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_uperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_uperf_percpu.tap])
416 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_qsbr_uperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_qsbr_uperf_perthread.tap])
417 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_perf_global.tap], [chmod +x tests/regression/rcutorture_urcu_signal_perf_global.tap])
418 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_perf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_signal_perf_percpu.tap])
419 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_perf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_signal_perf_perthread.tap])
420 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_rperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_signal_rperf_global.tap])
421 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_rperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_signal_rperf_percpu.tap])
422 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_rperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_signal_rperf_perthread.tap])
423 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_stress_global.tap], [chmod +x tests/regression/rcutorture_urcu_signal_stress_global.tap])
424 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_stress_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_signal_stress_percpu.tap])
425 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_stress_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_signal_stress_perthread.tap])
426 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_uperf_global.tap], [chmod +x tests/regression/rcutorture_urcu_signal_uperf_global.tap])
427 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_uperf_percpu.tap], [chmod +x tests/regression/rcutorture_urcu_signal_uperf_percpu.tap])
428 AC_CONFIG_FILES([tests/regression/rcutorture_urcu_signal_uperf_perthread.tap], [chmod +x tests/regression/rcutorture_urcu_signal_uperf_perthread.tap])
434 # Mini-report on what will be built.
442 AS_ECHO("${PPRINT_COLOR_BLDBLU}Userspace-RCU $PACKAGE_VERSION${PPRINT_COLOR_RST}")
445 PPRINT_SUBTITLE([Features])
447 PPRINT_PROP_STRING([Target architecture], $host_cpu)
449 # SMP support enabled/disabled
450 AE_IS_FEATURE_ENABLED([smp-support]) && value=1 || value=0
451 PPRINT_PROP_BOOL([SMP support], $value)
454 AE_IS_FEATURE_ENABLED([compiler-tls]) && value="compiler TLS" || value="pthread_getspecific()"
455 PPRINT_PROP_STRING([Thread Local Storage (TLS)], [$value])
457 # clock_gettime() available
458 test "x$ac_cv_search_function_clock_gettime" != "xno" && value=1 || value=0
459 PPRINT_PROP_BOOL([clock_gettime()], $value)
462 AE_IS_FEATURE_ENABLED([sys-membarrier-fallback]) && value=0 || value=1
463 PPRINT_PROP_BOOL([Require membarrier], $value)
465 # RCU debug enabled/disabled
466 AE_IS_FEATURE_ENABLED([rcu-debug]) && value=1 || value=0
467 PPRINT_PROP_BOOL([Internal debugging], $value)
469 # rculfhash iterator debug enabled/disabled
470 AE_IS_FEATURE_ENABLED([cds-lfht-iter-debug]) && value=1 || value=0
471 PPRINT_PROP_BOOL([Lock-free HT iterator debugging], $value)
473 PPRINT_PROP_BOOL([Multi-flavor support], 1)
475 report_bindir="`eval eval echo $bindir`"
476 report_libdir="`eval eval echo $libdir`"
478 # Print the bindir and libdir this 'make install' will install into.
480 PPRINT_SUBTITLE([Install directories])
481 PPRINT_PROP_STRING([Binaries], [$report_bindir])
482 PPRINT_PROP_STRING([Libraries], [$report_libdir])