[PATCH v3 12/25] linux: Add membarrier
Adhemerval Zanella
adhemerval.zanella@linaro.org
Mon Nov 16 19:42:25 GMT 2026
The membarrier system call (commit
5b25b13ab08f616efd566347d809b4ece54570d1, Linux 4.3) issues memory
barriers on a set of threads. It allows a synchronization algorithm
to replace the memory barrier on a frequently executed path with a
compiler barrier, and to issue the matching barrier only on an
infrequently executed path (as done by liburcu, for instance).
The cpu_id argument was added along with MEMBARRIER_CMD_FLAG_CPU
(commit 2a36ab717e8fe678d98f81c14a0b124712719840, Linux 5.10), and the
interface has been stable since then. The wrapper follows the current
kernel signature:
int membarrier (int cmd, unsigned int flags, int cpu_id);
musl provides a two-argument membarrier, which predates the cpu_id
argument.
The new <sys/membarrier.h> header includes <linux/membarrier.h> if it
is available and otherwise defines the same command enumerations. The
kernel header only defines enumerations, so its multiple inclusion
guard is used to avoid redefining them.
Checked on x86_64-linux-gnu and i686-linux-gnu.
Co-authored-by: Florian Weimer <fweimer@redhat.com>
---
NEWS | 4 +
manual/threads.texi | 89 +++++++++++
sysdeps/unix/sysv/linux/Makefile | 2 +
sysdeps/unix/sysv/linux/Versions | 3 +
sysdeps/unix/sysv/linux/aarch64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/alpha/libc.abilist | 1 +
sysdeps/unix/sysv/linux/arc/libc.abilist | 1 +
sysdeps/unix/sysv/linux/arm/be/libc.abilist | 1 +
sysdeps/unix/sysv/linux/arm/le/libc.abilist | 1 +
sysdeps/unix/sysv/linux/csky/libc.abilist | 1 +
sysdeps/unix/sysv/linux/hppa/libc.abilist | 1 +
sysdeps/unix/sysv/linux/i386/libc.abilist | 1 +
.../sysv/linux/loongarch/ilp32/libc.abilist | 1 +
.../sysv/linux/loongarch/lp64/libc.abilist | 1 +
.../sysv/linux/m68k/coldfire/libc.abilist | 1 +
.../unix/sysv/linux/m68k/m680x0/libc.abilist | 1 +
.../sysv/linux/microblaze/be/libc.abilist | 1 +
.../sysv/linux/microblaze/le/libc.abilist | 1 +
.../sysv/linux/mips/mips32/fpu/libc.abilist | 1 +
.../sysv/linux/mips/mips32/nofpu/libc.abilist | 1 +
.../sysv/linux/mips/mips64/n32/libc.abilist | 1 +
.../sysv/linux/mips/mips64/n64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/or1k/libc.abilist | 1 +
.../linux/powerpc/powerpc32/fpu/libc.abilist | 1 +
.../powerpc/powerpc32/nofpu/libc.abilist | 1 +
.../linux/powerpc/powerpc64/be/libc.abilist | 1 +
.../linux/powerpc/powerpc64/le/libc.abilist | 1 +
.../unix/sysv/linux/riscv/rv32/libc.abilist | 1 +
.../unix/sysv/linux/riscv/rv64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/s390/libc.abilist | 1 +
sysdeps/unix/sysv/linux/sh/be/libc.abilist | 1 +
sysdeps/unix/sysv/linux/sh/le/libc.abilist | 1 +
.../sysv/linux/sparc/sparc32/libc.abilist | 1 +
.../sysv/linux/sparc/sparc64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/sys/membarrier.h | 69 ++++++++
sysdeps/unix/sysv/linux/syscalls.list | 1 +
sysdeps/unix/sysv/linux/tst-membarrier.c | 151 ++++++++++++++++++
.../unix/sysv/linux/x86_64/64/libc.abilist | 1 +
.../unix/sysv/linux/x86_64/x32/libc.abilist | 1 +
39 files changed, 351 insertions(+)
create mode 100644 sysdeps/unix/sysv/linux/sys/membarrier.h
create mode 100644 sysdeps/unix/sysv/linux/tst-membarrier.c
diff --git a/NEWS b/NEWS
index a53aab4ce8d..6f6014a339b 100644
--- a/NEWS
+++ b/NEWS
@@ -12,6 +12,10 @@ Major new features:
* Additional optimized and correctly rounded mathematical functions have
been imported from the CORE-MATH project, in particular cbrt.
+* On Linux, the membarrier function has been added, along with the
+ <sys/membarrier.h> header. It issues memory barriers on a set of
+ threads.
+
Deprecated and removed features, and other changes affecting compatibility:
* The posix_spawn_file_actions_addchdir and posix_spawn_file_actions_addfchdir
diff --git a/manual/threads.texi b/manual/threads.texi
index 0331599bc09..38b182bedc8 100644
--- a/manual/threads.texi
+++ b/manual/threads.texi
@@ -1151,6 +1151,7 @@ the standard.
* Single-Threaded:: Detecting single-threaded execution.
* Restartable Sequences:: Linux-specific restartable sequences
integration.
+* Memory Barriers on Sets of Threads:: Linux-specific membarrier function.
@end menu
@node Default Thread Attributes
@@ -1547,6 +1548,94 @@ abort handler. Failure to provide the expected signature may terminate
the process with a segmentation fault.
@end deftypevr
+@node Memory Barriers on Sets of Threads
+@subsubsection Memory Barriers on Sets of Threads
+@cindex membarrier
+
+The @code{membarrier} function is a wrapper around the Linux
+@code{membarrier} system call, which issues memory barriers on a set of
+threads. It allows a synchronization algorithm to replace the memory
+barrier on a frequently executed path with a compiler barrier, and to
+issue the matching memory barrier only on an infrequently executed path.
+This functionality is only available on Linux.
+
+@deftypefun int membarrier (int @var{cmd}, unsigned int @var{flags}, int @var{cpu_id})
+@standards{Linux, sys/membarrier.h}
+@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
+Issue the memory barrier selected by @var{cmd}, which is one of the
+following commands. Each command other than @code{MEMBARRIER_CMD_QUERY}
+is a single bit.
+
+@vtable @code
+@item MEMBARRIER_CMD_QUERY
+Return the bit mask of the commands supported by the kernel.
+
+@item MEMBARRIER_CMD_GLOBAL
+Ensure that all the threads in the system pass through a state in which
+all their memory accesses are ordered with respect to the call, before
+it returns. This command is not supported if the kernel uses
+@code{nohz_full} CPUs.
+
+@item MEMBARRIER_CMD_GLOBAL_EXPEDITED
+@itemx MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED
+Like @code{MEMBARRIER_CMD_GLOBAL}, but only for the threads of the
+processes which have registered with
+@code{MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED}. This is faster than
+@code{MEMBARRIER_CMD_GLOBAL}.
+
+@item MEMBARRIER_CMD_PRIVATE_EXPEDITED
+@itemx MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED
+Like @code{MEMBARRIER_CMD_GLOBAL}, but only for the threads of the
+calling process. The process must register first with
+@code{MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED}.
+
+@item MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE
+@itemx MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE
+Like @code{MEMBARRIER_CMD_PRIVATE_EXPEDITED}, and in addition each thread
+executes a core serializing instruction, as required for cross-modifying
+code. The process must register first with
+@code{MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE}.
+
+@item MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ
+@itemx MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ
+Restart the restartable sequences critical sections being executed by
+the other threads of the calling process (@pxref{Restartable
+Sequences}). The process must register first with
+@code{MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ}.
+
+@item MEMBARRIER_CMD_GET_REGISTRATIONS
+Return the bit mask of the registration commands issued by the calling
+process.
+@end vtable
+
+The @var{flags} argument must be zero, except for
+@code{MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ}, for which it can also be
+@code{MEMBARRIER_CMD_FLAG_CPU}. In this case the command only applies
+to the thread running on the CPU @var{cpu_id}. Otherwise @var{cpu_id}
+is ignored.
+
+The return value is the bit mask described above for
+@code{MEMBARRIER_CMD_QUERY} and @code{MEMBARRIER_CMD_GET_REGISTRATIONS},
+and zero for the other commands. On failure, @minus{}1 is returned and
+@code{errno} is set to one of the following error codes:
+
+@table @code
+@item EINVAL
+The @var{cmd} command is unknown or not supported by the kernel, or
+@var{flags} is invalid.
+
+@item EPERM
+A private expedited command was issued without the corresponding
+registration.
+
+@item ENOMEM
+There is not enough memory to complete the command.
+
+@item ENOSYS
+The kernel does not implement the @code{membarrier} system call.
+@end table
+@end deftypefun
+
@c FIXME these are undocumented:
@c pthread_atfork
@c pthread_attr_destroy
diff --git a/sysdeps/unix/sysv/linux/Makefile b/sysdeps/unix/sysv/linux/Makefile
index ea500c14997..15a55de7f49 100644
--- a/sysdeps/unix/sysv/linux/Makefile
+++ b/sysdeps/unix/sysv/linux/Makefile
@@ -179,6 +179,7 @@ sysdep_headers += \
sys/inotify.h \
sys/kd.h \
sys/klog.h \
+ sys/membarrier.h \
sys/mount.h \
sys/pci.h \
sys/personality.h \
@@ -210,6 +211,7 @@ tests += \
tst-gettid \
tst-gettid-kill \
tst-linux-mremap1 \
+ tst-membarrier \
tst-memfd_create \
tst-misalign-clone \
tst-mlock2 \
diff --git a/sysdeps/unix/sysv/linux/Versions b/sysdeps/unix/sysv/linux/Versions
index c7f199f13f2..61696fad7fc 100644
--- a/sysdeps/unix/sysv/linux/Versions
+++ b/sysdeps/unix/sysv/linux/Versions
@@ -343,6 +343,9 @@ libc {
mseal;
openat2;
}
+ GLIBC_2.45 {
+ membarrier;
+ }
GLIBC_PRIVATE {
# functions used in other libraries
__syscall_rt_sigqueueinfo;
diff --git a/sysdeps/unix/sysv/linux/aarch64/libc.abilist b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
index ad0cbaa2ac8..4d09997cce3 100644
--- a/sysdeps/unix/sysv/linux/aarch64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
@@ -2775,5 +2775,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/alpha/libc.abilist b/sysdeps/unix/sysv/linux/alpha/libc.abilist
index 0e75090900e..8bd9a672d4b 100644
--- a/sysdeps/unix/sysv/linux/alpha/libc.abilist
+++ b/sysdeps/unix/sysv/linux/alpha/libc.abilist
@@ -3122,6 +3122,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/arc/libc.abilist b/sysdeps/unix/sysv/linux/arc/libc.abilist
index 2b40d1adecc..da45cbf90e8 100644
--- a/sysdeps/unix/sysv/linux/arc/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arc/libc.abilist
@@ -2536,5 +2536,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/arm/be/libc.abilist b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
index ae7f8787f53..7e34bc91516 100644
--- a/sysdeps/unix/sysv/linux/arm/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
@@ -2828,6 +2828,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/arm/le/libc.abilist b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
index 42a0e9816bd..f6cf2c520bc 100644
--- a/sysdeps/unix/sysv/linux/arm/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
@@ -2825,6 +2825,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/csky/libc.abilist b/sysdeps/unix/sysv/linux/csky/libc.abilist
index 17566797fc8..49e831b815f 100644
--- a/sysdeps/unix/sysv/linux/csky/libc.abilist
+++ b/sysdeps/unix/sysv/linux/csky/libc.abilist
@@ -2812,5 +2812,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/hppa/libc.abilist b/sysdeps/unix/sysv/linux/hppa/libc.abilist
index 5ae4bc610bd..27669e04a3c 100644
--- a/sysdeps/unix/sysv/linux/hppa/libc.abilist
+++ b/sysdeps/unix/sysv/linux/hppa/libc.abilist
@@ -2849,6 +2849,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/i386/libc.abilist b/sysdeps/unix/sysv/linux/i386/libc.abilist
index 5ed513a623d..307494d3ba8 100644
--- a/sysdeps/unix/sysv/linux/i386/libc.abilist
+++ b/sysdeps/unix/sysv/linux/i386/libc.abilist
@@ -3032,6 +3032,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
index 4dc42fb90ed..d1807e45e1b 100644
--- a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
@@ -2287,5 +2287,6 @@ GLIBC_2.44 wprintf F
GLIBC_2.44 write F
GLIBC_2.44 writev F
GLIBC_2.44 wscanf F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
index 1cf70f6cdf6..f81e37f3cc6 100644
--- a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
@@ -2296,5 +2296,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
index 4e4d4dbdfd6..a1315c2dd48 100644
--- a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
@@ -2808,6 +2808,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
index 58e80df2101..5b62f2b181e 100644
--- a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
@@ -2975,6 +2975,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
index ee7bd658186..44f42d6de64 100644
--- a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
@@ -2861,5 +2861,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
index 269c8e6315b..d2bcf51ac02 100644
--- a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
@@ -2858,5 +2858,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
index fc9609351e0..cfb821bb24e 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
@@ -2938,6 +2938,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
index 9ab36b5e2d8..b097351cbdc 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
@@ -2936,6 +2936,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
index 9ead3c2c896..492c23108e5 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
@@ -2944,6 +2944,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
index 18a00bc9a65..92537db667e 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
@@ -2846,6 +2846,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/or1k/libc.abilist b/sysdeps/unix/sysv/linux/or1k/libc.abilist
index 7c220c414ce..1a24723bb9a 100644
--- a/sysdeps/unix/sysv/linux/or1k/libc.abilist
+++ b/sysdeps/unix/sysv/linux/or1k/libc.abilist
@@ -2286,5 +2286,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
index 44fcc172a4b..ab7f9ae5e70 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
@@ -3165,6 +3165,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
index 33b91a001c5..fadc9c42b30 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
@@ -3210,6 +3210,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
index 638ea184d35..cf24061bfdb 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
@@ -2919,6 +2919,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
index 66b2d73497a..c4975eb3552 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
@@ -2995,5 +2995,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
index 5d832d13043..f18093a6236 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
@@ -2539,5 +2539,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
index ea97ab4f6a2..15c7b728f6a 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
@@ -2739,5 +2739,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
diff --git a/sysdeps/unix/sysv/linux/s390/libc.abilist b/sysdeps/unix/sysv/linux/s390/libc.abilist
index 703c402f99a..ad14f4cc0a8 100644
--- a/sysdeps/unix/sysv/linux/s390/libc.abilist
+++ b/sysdeps/unix/sysv/linux/s390/libc.abilist
@@ -2956,6 +2956,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/sh/be/libc.abilist b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
index 47079e00ca9..3f2d470ad0d 100644
--- a/sysdeps/unix/sysv/linux/sh/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
@@ -2855,6 +2855,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/sh/le/libc.abilist b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
index 21677414a59..e69c1d4ff48 100644
--- a/sysdeps/unix/sysv/linux/sh/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
@@ -2852,6 +2852,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
index 52515956fcc..42bef5fefa5 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
@@ -3186,6 +3186,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
index 2f2dc8a456a..73490c21bf7 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
@@ -2822,6 +2822,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/sys/membarrier.h b/sysdeps/unix/sysv/linux/sys/membarrier.h
new file mode 100644
index 00000000000..50f95459a37
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/sys/membarrier.h
@@ -0,0 +1,69 @@
+/* Memory barriers on sets of threads. Linux version.
+ Copyright (C) 2026 Free Software Foundation, Inc.
+ This file is part of the GNU C Library.
+
+ The GNU C Library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ The GNU C Library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with the GNU C Library; if not, see
+ <https://www.gnu.org/licenses/>. */
+
+#ifndef _SYS_MEMBARRIER_H
+#define _SYS_MEMBARRIER_H 1
+
+#include <features.h>
+
+#ifdef __has_include
+# if __has_include ("linux/membarrier.h")
+# include "linux/membarrier.h"
+# endif
+#endif
+
+#ifndef _LINUX_MEMBARRIER_H
+enum membarrier_cmd
+{
+ MEMBARRIER_CMD_QUERY = 0,
+ MEMBARRIER_CMD_GLOBAL = (1 << 0),
+ MEMBARRIER_CMD_GLOBAL_EXPEDITED = (1 << 1),
+ MEMBARRIER_CMD_REGISTER_GLOBAL_EXPEDITED = (1 << 2),
+ MEMBARRIER_CMD_PRIVATE_EXPEDITED = (1 << 3),
+ MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED = (1 << 4),
+ MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE = (1 << 5),
+ MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_SYNC_CORE = (1 << 6),
+ MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ = (1 << 7),
+ MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ = (1 << 8),
+ MEMBARRIER_CMD_GET_REGISTRATIONS = (1 << 9),
+
+ MEMBARRIER_CMD_SHARED = MEMBARRIER_CMD_GLOBAL
+};
+
+enum membarrier_cmd_flag
+{
+ /* Restrict MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ to the CPU given by the
+ CPU_ID argument. */
+ MEMBARRIER_CMD_FLAG_CPU = (1 << 0)
+};
+#endif /* !_LINUX_MEMBARRIER_H */
+
+__BEGIN_DECLS
+
+/* Issue the memory barrier selected by CMD on a set of threads. FLAGS is
+ zero or MEMBARRIER_CMD_FLAG_CPU, in which case CPU_ID selects the CPU
+ (otherwise it is ignored). Returns 0 (or the mask of supported commands
+ for MEMBARRIER_CMD_QUERY, or the mask of registered commands for
+ MEMBARRIER_CMD_GET_REGISTRATIONS) on success, or -1 and sets errno on
+ failure. */
+extern int membarrier (int __cmd, unsigned int __flags, int __cpu_id)
+ __THROW;
+
+__END_DECLS
+
+#endif /* sys/membarrier.h */
diff --git a/sysdeps/unix/sysv/linux/syscalls.list b/sysdeps/unix/sysv/linux/syscalls.list
index 2af3aec8cd0..674cb1225ae 100644
--- a/sysdeps/unix/sysv/linux/syscalls.list
+++ b/sysdeps/unix/sysv/linux/syscalls.list
@@ -33,6 +33,7 @@ ioperm - ioperm i:UUi ioperm
iopl - iopl i:i iopl
klogctl EXTRA syslog i:isi klogctl
lchown - lchown i:sii __lchown lchown
+membarrier EXTRA membarrier i:iUi membarrier
mincore - mincore i:aUV mincore
mlock - mlock i:bU mlock
mlockall - mlockall i:i mlockall
diff --git a/sysdeps/unix/sysv/linux/tst-membarrier.c b/sysdeps/unix/sysv/linux/tst-membarrier.c
new file mode 100644
index 00000000000..421e185b4ae
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/tst-membarrier.c
@@ -0,0 +1,151 @@
+/* Basic tests for Linux membarrier.
+ Copyright (C) 2026 Free Software Foundation, Inc.
+ This file is part of the GNU C Library.
+
+ The GNU C Library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ The GNU C Library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with the GNU C Library; if not, see
+ <https://www.gnu.org/licenses/>. */
+
+#include <errno.h>
+#include <sched.h>
+#include <stdbool.h>
+#include <stdio.h>
+#include <string.h>
+#include <unistd.h>
+#include <support/check.h>
+#include <support/xstdio.h>
+#include <support/xthread.h>
+#include <sys/membarrier.h>
+
+/* MEMBARRIER_CMD_GET_REGISTRATIONS, which kernel headers older than Linux
+ 6.3 do not define. */
+#define CMD_GET_REGISTRATIONS (1 << 9)
+
+static pthread_barrier_t barrier;
+
+/* Return 1 if the kernel runs some CPUs in nohz_full mode, 0 if it does
+ not, and -1 if this cannot be determined (sysfs is not available). */
+static int
+nohz_full (void)
+{
+ FILE *f = fopen ("/sys/devices/system/cpu/nohz_full", "r");
+ if (f == NULL)
+ /* The file only exists if the kernel supports nohz_full. */
+ return access ("/sys/devices/system/cpu", F_OK) == 0 ? 0 : -1;
+ /* The file lists the nohz_full CPUs. If there is none, Linux 6.19 and
+ later print an empty line, while earlier versions print either an empty
+ line or (null) padded wit spaces to the number of possible CPUS (if the
+ CPU mask is not allocated). */
+ char buf[32];
+ bool cpus = (fscanf (f, "%31s", buf) == 1 && strcmp (buf, "(null)") != 0);
+ xfclose (f);
+ return cpus;
+}
+
+static void *
+thread_func (void *closure)
+{
+ xpthread_barrier_wait (&barrier);
+ return NULL;
+}
+
+static int
+do_test (void)
+{
+ int mask = membarrier (MEMBARRIER_CMD_QUERY, 0, 0);
+ if (mask == -1 && errno == ENOSYS)
+ FAIL_UNSUPPORTED ("membarrier is not supported by the kernel");
+ TEST_VERIFY_EXIT (mask >= 0);
+ printf ("info: supported commands: 0x%x\n", mask);
+
+ /* Flags are only accepted by MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ. */
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_QUERY, MEMBARRIER_CMD_FLAG_CPU, 0),
+ -1);
+ TEST_COMPARE (errno, EINVAL);
+
+ TEST_COMPARE (membarrier (CMD_GET_REGISTRATIONS << 1, 0, 0), -1);
+ TEST_COMPARE (errno, EINVAL);
+
+ /* MEMBARRIER_CMD_SHARED, the original name of MEMBARRIER_CMD_GLOBAL, is
+ implemented by every kernel with membarrier. It is not compatible with
+ nohz_full CPUs, so such kernels neither report nor accept it. */
+ _Static_assert (MEMBARRIER_CMD_SHARED == MEMBARRIER_CMD_GLOBAL,
+ "MEMBARRIER_CMD_SHARED != MEMBARRIER_CMD_GLOBAL");
+ int nohz = nohz_full ();
+ if (nohz == 0)
+ TEST_VERIFY (mask & MEMBARRIER_CMD_SHARED);
+ else if (nohz == 1)
+ TEST_VERIFY (!(mask & MEMBARRIER_CMD_SHARED));
+ if (mask & MEMBARRIER_CMD_SHARED)
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_SHARED, 0, 0), 0);
+ else
+ {
+ printf ("info: MEMBARRIER_CMD_SHARED not supported (nohz_full: %d)\n",
+ nohz);
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_SHARED, 0, 0), -1);
+ TEST_COMPARE (errno, EINVAL);
+ }
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_SHARED, MEMBARRIER_CMD_FLAG_CPU, 0),
+ -1);
+ TEST_COMPARE (errno, EINVAL);
+
+ /* Keep a second thread alive, so the private expedited commands are not
+ handled as single-threaded processes. */
+ xpthread_barrier_init (&barrier, NULL, 2);
+ pthread_t thr = xpthread_create (NULL, thread_func, NULL);
+
+ if (mask & MEMBARRIER_CMD_PRIVATE_EXPEDITED)
+ {
+ /* The process must register its intent first. */
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_PRIVATE_EXPEDITED, 0, 0), -1);
+ TEST_COMPARE (errno, EPERM);
+
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED,
+ 0, 0), 0);
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_PRIVATE_EXPEDITED, 0, 0), 0);
+
+ if (mask & CMD_GET_REGISTRATIONS)
+ {
+ int regs = membarrier (CMD_GET_REGISTRATIONS, 0, 0);
+ TEST_VERIFY (regs >= 0);
+ TEST_VERIFY (regs & MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED);
+ }
+ }
+
+ if (mask & MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ)
+ {
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ,
+ 0, 0), 0);
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ, 0, 0),
+ 0);
+
+ /* Restrict the barrier to the current CPU. */
+ int cpu = sched_getcpu ();
+ if (cpu < 0)
+ cpu = 0;
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ,
+ MEMBARRIER_CMD_FLAG_CPU, cpu), 0);
+
+ TEST_COMPARE (membarrier (MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ,
+ MEMBARRIER_CMD_FLAG_CPU << 1, cpu), -1);
+ TEST_COMPARE (errno, EINVAL);
+ }
+
+ xpthread_barrier_wait (&barrier);
+ xpthread_join (thr);
+ xpthread_barrier_destroy (&barrier);
+
+ return 0;
+}
+
+#include <support/test-driver.c>
diff --git a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
index 286fe42a5b4..0ca23d8d22a 100644
--- a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
@@ -2771,6 +2771,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
GLIBC_2.5 __readlinkat_chk F
diff --git a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
index b6f3ea7d2d8..6add9657b39 100644
--- a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
@@ -2790,5 +2790,6 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 membarrier F
GLIBC_2.45 posix_spawn_file_actions_addchdir F
GLIBC_2.45 posix_spawn_file_actions_addfchdir F
--
2.53.0
More information about the Libc-alpha
mailing list