[PATCH v3 3/3] linux: Add futex_waitv

Gabriel Ravier gabravier@gmail.com
Fri Nov 6 08:41:21 GMT 2026


On 8/25/26 6:50 PM, Adhemerval Zanella wrote:
> Add a wrapper for the futex_waitv system call to <sys/futex.h>:
> 
>    struct futex_waiter
>    {
>      uint64_t val;
>      uint64_t uaddr;
>      uint32_t flags;
>      uint32_t __reserved;
>    };
> 
>    int futex_waitv (const struct futex_waiter *waiters,
>                     unsigned int nwaiters, unsigned int flags,
>                     clockid_t clockid, const struct timespec *abstime);
> 
> It blocks on up to FUTEX_WAITV_MAX (128) futexes at the same time
> until any of them is woken.  On success it returns the array index of
> the woken futex; on failure it returns -1 and sets errno.  The timeout
> is absolute, measured against CLOCK_REALTIME or CLOCK_MONOTONIC.
> 
> The struct futex_waiter has the same layout as the kernel struct
> futex_waitv and each entry carries the kernel FUTEX2_* flags. The only
> extra handling is the negative absolute timeout, which the kernel
> rejects with EINVAL and the wrapper reports as ETIMEDOUT.
> 
> The underlying system call only supports 64-bit time_t and so does the
> wrapper.
> 
> Checked on x86_64-linux-gnu and i686-linux-gnu.
> ---
>   NEWS                                          |   4 +
>   include/sys/futex.h                           |   5 +
>   manual/threads.texi                           |  85 +++++++-
>   sysdeps/unix/sysv/linux/Makefile              |  13 ++
>   sysdeps/unix/sysv/linux/Versions              |   1 +
>   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/futex_waitv.c         |  38 ++++
>   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/futex.h           |  50 +++++
>   sysdeps/unix/sysv/linux/tst-futex-consts.py   |  71 +++++++
>   .../unix/sysv/linux/tst-futex-waitv-time64.c  |   1 +
>   sysdeps/unix/sysv/linux/tst-futex-waitv.c     | 197 ++++++++++++++++++
>   .../unix/sysv/linux/x86_64/64/libc.abilist    |   1 +
>   .../unix/sysv/linux/x86_64/x32/libc.abilist   |   1 +
>   42 files changed, 496 insertions(+), 1 deletion(-)
>   create mode 100644 sysdeps/unix/sysv/linux/futex_waitv.c
>   create mode 100644 sysdeps/unix/sysv/linux/tst-futex-consts.py
>   create mode 100644 sysdeps/unix/sysv/linux/tst-futex-waitv-time64.c
>   create mode 100644 sysdeps/unix/sysv/linux/tst-futex-waitv.c
> 
> diff --git a/NEWS b/NEWS
> index 805a71b639..eec3907c71 100644
> --- a/NEWS
> +++ b/NEWS
> @@ -14,6 +14,10 @@ Major new features:
>     the futex system call and provide the blocking building block for
>     implementing custom synchronization primitives.
>   
> +* On Linux, the futex_waitv function has been added.  It allows waiting
> +  on multiple futexes at the same time, reporting the index of the woken
> +  one.
> +
>   Deprecated and removed features, and other changes affecting compatibility:
>   
>     [Add deprecations, removals and changes affecting compatibility here]
> diff --git a/include/sys/futex.h b/include/sys/futex.h
> index 602096a738..ec19fcd042 100644
> --- a/include/sys/futex.h
> +++ b/include/sys/futex.h
> @@ -21,6 +21,11 @@ extern int __futex_timedwait_time64 (uint32_t *futexp, uint32_t expected,
>   				     unsigned int flags)
>        __nonnull ((1));
>   libc_hidden_proto (__futex_timedwait_time64)
> +extern int futex_waitv (const struct futex_waiter *waiters,
> +			unsigned int nwaiters, unsigned int flags,
> +			const struct __timespec64 *abstime,
> +			clockid_t clockid)
> +     __nonnull ((1));
>   # endif
>   
>   # endif /* !_ISOMAC */
> diff --git a/manual/threads.texi b/manual/threads.texi
> index 16c716f0ab..fffd1fabb9 100644
> --- a/manual/threads.texi
> +++ b/manual/threads.texi
> @@ -1582,7 +1582,8 @@ the kernel to use faster process-local bookkeeping.  Without it, the
>   futex word may be accessed by multiple processes through a shared
>   memory mapping (@code{MAP_SHARED}).  Waiters and wakers of one futex
>   word must agree on this flag.  The value follows the kernel
> -@code{FUTEX_PRIVATE_FLAG}.
> +@code{FUTEX_PRIVATE_FLAG}, so the same value is used by the
> +@code{futex_waitv} per-waiter flags.
>   
>   @deftypefun int futex_wait (uint32_t *@var{futexp}, uint32_t @var{expected}, unsigned int @var{flags})
>   @standards{Linux, sys/futex.h}
> @@ -1675,6 +1676,88 @@ same address, @var{nwake} or @var{nrequeue} are negative, or
>   @end table
>   @end deftypefun
>   
> +@deftp {Data Type} {struct futex_waiter}
> +@standards{Linux, sys/futex.h}
> +Describes one futex to wait on in a call to @code{futex_waitv}.  It
> +has the same layout as the kernel @code{struct futex_waitv} and the
> +following members:
> +
> +@table @code
> +@item uint64_t val
> +The value the futex word is expected to contain, as for
> +@code{futex_wait}.
> +
> +@item uint64_t uaddr
> +The address of the futex word.
> +
> +@item uint32_t flags
> +The kernel @code{FUTEX2_*} flags for this futex word:
> +@code{FUTEX2_SIZE_U32}, optionally combined with @code{FUTEX2_PRIVATE}
> +(equal to @code{FUTEX_PRIVATE_FLAG}) if the futex word is only used by
> +threads of the calling process, @code{FUTEX2_NUMA} if the futex word
> +is followed by a second 32-bit word holding the NUMA node id of the
> +kernel state (with @code{FUTEX_NO_NODE} letting the kernel choose the
> +node), and @code{FUTEX2_MPOL}.
> +
> +@item uint32_t __reserved
> +Reserved for future use; must be zero.
> +@end table
> +@end deftp
> +
> +@deftypevr Macro int FUTEX_WAITV_MAX
> +@standards{Linux, sys/futex.h}
> +The maximum number of elements of the array passed to @code{futex_waitv},
> + currently 128.
> +@end deftypevr
> +
> +@deftypefun int futex_waitv (const struct futex_waiter *@var{waiters}, unsigned int @var{nwaiters}, unsigned int @var{flags}, const struct timespec *@var{abstime}, clockid_t @var{clockid})
> +@standards{Linux, sys/futex.h}
> +@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
> +Wait on all of the @var{nwaiters} futex words described by the array
> +@var{waiters}, blocking until any one of them is woken (or until a
> +spurious wake-up).  Each futex word is checked against the expected
> +value recorded in its array entry, atomically with respect to
> +concurrent futex operations, as for @code{futex_wait}.
> +
> +The wait is bounded by the absolute time @var{abstime} measured
> +against the clock @var{clockid}, which must be @code{CLOCK_REALTIME}
> +or @code{CLOCK_MONOTONIC}.  If @var{abstime} is a null pointer, the
> +call blocks without a timeout.
> +
> +The @var{flags} argument is the flags argument of the underlying
> +system call and is passed to the kernel unchanged; the system call
> +currently supports no flags, so it must be zero.
> +
> +The return value is the array index of one of the woken futex words,
> +or @minus{}1 with @code{errno} set to one of the following error
> +codes.
> +
> +@table @code
> +@item EAGAIN
> +A futex word did not contain the value expected by its array entry at
> +the time of the call.
> +
> +@item EINTR
> +The wait was interrupted by a signal handler.
> +
> +@item ETIMEDOUT
> +The absolute time @var{abstime} passed before any futex word was
> +woken.
> +
> +@item EINVAL
> +@var{nwaiters} is zero or greater than @code{FUTEX_WAITV_MAX}, a futex
> +word is not aligned to four bytes, a @code{flags} member is not valid,
> +or @var{clockid} is not a supported clock.
> +
> +@item ENOSYS
> +The kernel does not support the @code{futex_waitv} system call, which
> +was added in Linux 5.16.
> +@end table
> +
> +This function only operates on 64-bit @code{time_t} and is only declared
> +when @code{time_t} is a 64-bit type.
> +@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 f6c4672a07..3eab633b3b 100644
> --- a/sysdeps/unix/sysv/linux/Makefile
> +++ b/sysdeps/unix/sysv/linux/Makefile
> @@ -77,6 +77,7 @@ sysdep_routines += \
>     futex_requeue \
>     futex_timedwait \
>     futex_wait \
> +  futex_waitv \
>     futex_wake \
>     fxstat \
>     fxstat64 \
> @@ -205,6 +206,7 @@ tests += \
>     tst-fanotify \
>     tst-fdopendir-o_path \
>     tst-futex \
> +  tst-futex-waitv \
>     tst-getauxval \
>     tst-gettid \
>     tst-gettid-kill \
> @@ -282,6 +284,7 @@ tests-time64 += \
>     tst-clock_adjtime-time64 \
>     tst-epoll-time64 \
>     tst-futex-time64 \
> +  tst-futex-waitv-time64 \
>     tst-ntp_adjtime-time64 \
>     tst-ntp_gettime-time64 \
>     tst-ntp_gettimex-time64 \
> @@ -390,6 +393,16 @@ $(objpfx)tst-pidfd-consts.out: ../sysdeps/unix/sysv/linux/tst-pidfd-consts.py
>   	  < /dev/null > $@ 2>&1; $(evaluate-test)
>   $(objpfx)tst-pidfd-consts.out: $(sysdeps-linux-python-deps)
>   
> +tests-special += \
> +  $(objpfx)tst-futex-consts.out \
> +  # tests-special
> +$(objpfx)tst-futex-consts.out: ../sysdeps/unix/sysv/linux/tst-futex-consts.py
> +	$(sysdeps-linux-python) \
> +	  ../sysdeps/unix/sysv/linux/tst-futex-consts.py \
> +	    $(sysdeps-linux-python-cc) \
> +	  < /dev/null > $@ 2>&1; $(evaluate-test)
> +$(objpfx)tst-futex-consts.out: $(sysdeps-linux-python-deps)
> +
>   tests-special += \
>     $(objpfx)tst-mount-consts.out \
>     # tests-special
> diff --git a/sysdeps/unix/sysv/linux/Versions b/sysdeps/unix/sysv/linux/Versions
> index b417759862..bd92f21d9d 100644
> --- a/sysdeps/unix/sysv/linux/Versions
> +++ b/sysdeps/unix/sysv/linux/Versions
> @@ -350,6 +350,7 @@ libc {
>   %endif
>       futex_timedwait;
>       futex_wait;
> +    futex_waitv;
>       futex_wake;
>     }
>     GLIBC_PRIVATE {
> diff --git a/sysdeps/unix/sysv/linux/aarch64/libc.abilist b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
> index 9ac3743c8d..738626576c 100644
> --- a/sysdeps/unix/sysv/linux/aarch64/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
> @@ -2778,4 +2778,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/alpha/libc.abilist b/sysdeps/unix/sysv/linux/alpha/libc.abilist
> index 93781d00f1..53085aa5d0 100644
> --- a/sysdeps/unix/sysv/linux/alpha/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/alpha/libc.abilist
> @@ -3125,6 +3125,7 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/arc/libc.abilist b/sysdeps/unix/sysv/linux/arc/libc.abilist
> index f081a512c2..3bde0417c9 100644
> --- a/sysdeps/unix/sysv/linux/arc/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/arc/libc.abilist
> @@ -2539,4 +2539,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/arm/be/libc.abilist b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
> index 43b75f779a..1c9c1cdc26 100644
> --- a/sysdeps/unix/sysv/linux/arm/be/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
> @@ -2832,6 +2832,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/arm/le/libc.abilist b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
> index 0dd5e4948f..811a07e242 100644
> --- a/sysdeps/unix/sysv/linux/arm/le/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
> @@ -2829,6 +2829,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/csky/libc.abilist b/sysdeps/unix/sysv/linux/csky/libc.abilist
> index c7675ff2ef..4280091906 100644
> --- a/sysdeps/unix/sysv/linux/csky/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/csky/libc.abilist
> @@ -2816,4 +2816,5 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/futex_waitv.c b/sysdeps/unix/sysv/linux/futex_waitv.c
> new file mode 100644
> index 0000000000..5f0ca9057f
> --- /dev/null
> +++ b/sysdeps/unix/sysv/linux/futex_waitv.c
> @@ -0,0 +1,38 @@
> +/* Wait on multiple futexes.
> +   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 <time.h>
> +#include <sys/futex.h>
> +#include <sysdep.h>
> +
> +int
> +futex_waitv (const struct futex_waiter *waiters, unsigned int nwaiters,
> +	     unsigned int flags, const struct __timespec64 *abstime,
> +	     clockid_t clockid)
> +{
> +  int r;
> +  if (__glibc_unlikely (abstime != NULL && abstime->tv_sec < 0))
> +    r = -ETIMEDOUT;
> +  else
> +    r = INTERNAL_SYSCALL_CALL (futex_waitv, waiters, nwaiters, flags,
> +			       abstime, clockid);
> +  return INTERNAL_SYSCALL_ERROR_P (r)
> +         ? INLINE_SYSCALL_ERROR_RETURN_VALUE (-r)
> +         : r;
> +}
> diff --git a/sysdeps/unix/sysv/linux/hppa/libc.abilist b/sysdeps/unix/sysv/linux/hppa/libc.abilist
> index 70957e8d70..07a11c8a05 100644
> --- a/sysdeps/unix/sysv/linux/hppa/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/hppa/libc.abilist
> @@ -2853,6 +2853,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/i386/libc.abilist b/sysdeps/unix/sysv/linux/i386/libc.abilist
> index 0543cc2540..47d4ab3ee2 100644
> --- a/sysdeps/unix/sysv/linux/i386/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/i386/libc.abilist
> @@ -3036,6 +3036,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
> index 74b16c137f..4be7871d11 100644
> --- a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
> @@ -2290,4 +2290,5 @@ GLIBC_2.44 wscanf F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
> index 2962b730e8..c86486b76b 100644
> --- a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
> @@ -2299,4 +2299,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
> index 96c17703fd..4bd809f238 100644
> --- a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
> @@ -2812,6 +2812,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
> index a392bf3a3a..e0556e4a4f 100644
> --- a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
> @@ -2979,6 +2979,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
> index 1c419e0558..aa959e7d89 100644
> --- a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
> @@ -2865,4 +2865,5 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
> index 236b0a9949..1ffb895b90 100644
> --- a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
> @@ -2862,4 +2862,5 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
> index 59673b7709..40390d67c3 100644
> --- a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
> @@ -2942,6 +2942,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
> index 2cf11e9bd9..f0b9120c7f 100644
> --- a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
> @@ -2940,6 +2940,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
> index 12fcf6c276..fdd3b120a4 100644
> --- a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
> @@ -2948,6 +2948,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
> index d2056aa028..cec2301f61 100644
> --- a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
> @@ -2849,6 +2849,7 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/or1k/libc.abilist b/sysdeps/unix/sysv/linux/or1k/libc.abilist
> index 7b82f1b2c8..98bdfd38d3 100644
> --- a/sysdeps/unix/sysv/linux/or1k/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/or1k/libc.abilist
> @@ -2289,4 +2289,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
> index 6ace1864a0..cbddfdb962 100644
> --- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
> @@ -3169,6 +3169,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
> index 556cb13f78..fd3deb9994 100644
> --- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
> @@ -3214,6 +3214,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
> index aede41f65e..3147bba3c0 100644
> --- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
> @@ -2922,6 +2922,7 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
> index 60ee39b40c..c87ef1e840 100644
> --- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
> @@ -2998,4 +2998,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
> index 3760aa9c2e..3ad3deb6f4 100644
> --- a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
> @@ -2542,4 +2542,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
> index 4f19643514..bd10acb85b 100644
> --- a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
> @@ -2742,4 +2742,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
> diff --git a/sysdeps/unix/sysv/linux/s390/libc.abilist b/sysdeps/unix/sysv/linux/s390/libc.abilist
> index 76d21db2a8..657bcfa87c 100644
> --- a/sysdeps/unix/sysv/linux/s390/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/s390/libc.abilist
> @@ -2959,6 +2959,7 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/sh/be/libc.abilist b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
> index ff8093da80..5a74a6108b 100644
> --- a/sysdeps/unix/sysv/linux/sh/be/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
> @@ -2859,6 +2859,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/sh/le/libc.abilist b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
> index acca32532b..1ad6937047 100644
> --- a/sysdeps/unix/sysv/linux/sh/le/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
> @@ -2856,6 +2856,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
> index baa6d23a8e..21e4f5f13b 100644
> --- a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
> @@ -3190,6 +3190,7 @@ GLIBC_2.45 __futex_timedwait_time64 F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
> index 4224217e0c..1877ed350f 100644
> --- a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
> @@ -2825,6 +2825,7 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/sys/futex.h b/sysdeps/unix/sysv/linux/sys/futex.h
> index 2830ae05fa..986869752f 100644
> --- a/sysdeps/unix/sysv/linux/sys/futex.h
> +++ b/sysdeps/unix/sysv/linux/sys/futex.h
> @@ -29,6 +29,42 @@
>   # define FUTEX_PRIVATE_FLAG	128
>   #endif
>   
> +/* Maximum number of entries in the array passed to futex_waitv.  */
> +#define FUTEX_WAITV_MAX		128
> +
> +/* Per-waiter flags for futex_waitv, following the kernel definitions
> +   from <linux/futex.h>.  FUTEX2_PRIVATE equals FUTEX_PRIVATE_FLAG, so
> +   the same value is used by all futex_* operations.  */
> +#ifndef FUTEX2_SIZE_U32
> +# define FUTEX2_SIZE_U32	0x02
> +#endif
> +#ifndef FUTEX2_PRIVATE
> +# define FUTEX2_PRIVATE		FUTEX_PRIVATE_FLAG
> +#endif
> +/* With FUTEX2_NUMA the futex word is followed by a second 32-bit word
> +   holding the NUMA node id of the kernel state associated with the
> +   futex; FUTEX_NO_NODE there lets the kernel choose the node.
> +   FUTEX2_MPOL applies the memory policy of the futex word address.  */
> +#ifndef FUTEX2_NUMA
> +# define FUTEX2_NUMA		0x04
> +#endif
> +#ifndef FUTEX2_MPOL
> +# define FUTEX2_MPOL		0x08
> +#endif
> +#ifndef FUTEX_NO_NODE
> +# define FUTEX_NO_NODE		(-1)
> +#endif
> +
> +/* One futex to wait on in a futex_waitv call, with the same layout as
> +   the kernel struct futex_waitv.  */
> +struct futex_waiter
> +{
> +  uint64_t val;			/* Expected value of the futex word.  */
> +  uint64_t uaddr;		/* Address of the futex word.  */
> +  uint32_t flags;		/* FUTEX2_* flags for this futex word.  */
> +  uint32_t __reserved;		/* Must be zero.  */
> +};
> +
>   __BEGIN_DECLS
>   
>   /* If *FUTEXP == EXPECTED block until woken by futex_wake (or spuriously).
> @@ -80,6 +116,20 @@ extern int futex_requeue (uint32_t *__futexp, uint32_t __expected,
>   			  unsigned int __flags)
>        __THROW __nonnull ((1, 4));
>   
> +/* Block on all of the NWAITERS futex words described by WAITERS (at most
> +   FUTEX_WAITV_MAX entries) until woken on any of them or until the absolute
> +   timeout ABSTIME measured against CLOCKID (which must be CLOCK_REALTIME or
> +   CLOCK_MONOTONIC) passes.  If ABSTIME is null, block without a timeout.
> +   Each entry checks its own expected value and carries its own FUTEX2_*
> +   flags (FUTEX2_SIZE_U32, optionally with FUTEX2_PRIVATE).  */
> +#ifdef __USE_TIME_BITS64
> +extern int futex_waitv (const struct futex_waiter *__waiters,
> +			unsigned int __nwaiters, unsigned int __flags,
> +			const struct timespec *__abstime,
> +			clockid_t __clockid)
> +     __THROW __nonnull ((1));
> +#endif
> +
>   __END_DECLS
>   
>   #endif /* sys/futex.h */
> diff --git a/sysdeps/unix/sysv/linux/tst-futex-consts.py b/sysdeps/unix/sysv/linux/tst-futex-consts.py
> new file mode 100644
> index 0000000000..aef0cf3e1b
> --- /dev/null
> +++ b/sysdeps/unix/sysv/linux/tst-futex-consts.py
> @@ -0,0 +1,71 @@
> +#!/usr/bin/python3
> +# Test that glibc's sys/futex.h constants match the kernel's.
> +# 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/>.
> +
> +import argparse
> +import sys
> +
> +import glibcextract
> +import glibcsyscalls
> +
> +
> +def main():
> +    """The main entry point."""
> +    parser = argparse.ArgumentParser(
> +        description="Test that glibc's sys/futex.h constants "
> +        "match the kernel's.")
> +    parser.add_argument('--cc', metavar='CC',
> +                        help='C compiler (including options) to use')
> +    args = parser.parse_args()
> +
> +    if glibcextract.compile_c_snippet(
> +            '#include <linux/futex.h>',
> +            args.cc).returncode != 0:
> +        sys.exit (77)
> +
> +    linux_version_headers = glibcsyscalls.linux_kernel_version(args.cc)
> +    # Constants in glibc were updated to match Linux v7.1.  When glibc
> +    # constants are updated this value should be updated to match the
> +    # released kernel version from which the constants were taken, and
> +    # the futex_waitv per-waiter flags handling should be revisited for
> +    # any new FUTEX2_* flag.
> +    linux_version_glibc = (7, 1)
> +    def check(cte, exclude=None):
> +        return glibcextract.compare_macro_consts(
> +                '#include <sys/futex.h>\n',
> +                '#include <linux/futex.h>\n',
> +                args.cc,
> +                cte,
> +                exclude,
> +                linux_version_glibc > linux_version_headers,
> +                linux_version_headers > linux_version_glibc)
> +
> +    status = max(
> +        check('FUTEX_WAITV_MAX'),
> +        check('FUTEX_PRIVATE_FLAG'),
> +        check('FUTEX_NO_NODE'),
> +        # glibc only defines the FUTEX2_* flags currently accepted by
> +        # the futex_waitv system call; the sizes other than 32-bit and
> +        # the size mask are not provided.
> +        check('FUTEX2_.*',
> +              'FUTEX2_SIZE_U8|FUTEX2_SIZE_U16|FUTEX2_SIZE_U64'
> +              '|FUTEX2_SIZE_MASK'))
> +    sys.exit(status)
> +
> +if __name__ == '__main__':
> +    main()
> diff --git a/sysdeps/unix/sysv/linux/tst-futex-waitv-time64.c b/sysdeps/unix/sysv/linux/tst-futex-waitv-time64.c
> new file mode 100644
> index 0000000000..1c1255bf17
> --- /dev/null
> +++ b/sysdeps/unix/sysv/linux/tst-futex-waitv-time64.c
> @@ -0,0 +1 @@
> +#include "tst-futex-waitv.c"
> diff --git a/sysdeps/unix/sysv/linux/tst-futex-waitv.c b/sysdeps/unix/sysv/linux/tst-futex-waitv.c
> new file mode 100644
> index 0000000000..9dd14db86e
> --- /dev/null
> +++ b/sysdeps/unix/sysv/linux/tst-futex-waitv.c
> @@ -0,0 +1,197 @@
> +/* Test for futex_waitv.
> +   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 <limits.h>
> +#include <stdint.h>
> +#include <sys/futex.h>
> +#include <sys/wait.h>
> +#include <unistd.h>
> +#include <support/check.h>
> +#include <support/test-driver.h>
> +
> +/* futex_waitv is only declared when time_t is a 64-bit type.  */
> +#ifdef __USE_TIME_BITS64
> +
> +# include <support/support.h>
> +# include <support/timespec.h>
> +# include <support/xthread.h>
> +# include <support/xtime.h>
> +# include <support/xunistd.h>
> +
> +static uint32_t ftx1;
> +static uint32_t ftx2;
> +static int waiter_result;
> +
> +static void *
> +waiter_tf (void *closure)
> +{
> +  struct futex_waiter waiters[] =
> +    {
> +      { .val = 0, .uaddr = (uintptr_t) &ftx1,
> +	.flags = FUTEX2_SIZE_U32 | FUTEX2_PRIVATE },
> +      { .val = 0, .uaddr = (uintptr_t) &ftx2,
> +	.flags = FUTEX2_SIZE_U32 | FUTEX2_PRIVATE },
> +    };
> +  int r;
> +  do
> +    r = futex_waitv (waiters, 2, 0, NULL, CLOCK_MONOTONIC);
> +  while (r == -1 && errno == EINTR);
> +  TEST_VERIFY (r >= 0);
> +  __atomic_store_n (&waiter_result, r + 1, __ATOMIC_RELEASE);
> +  return NULL;
> +}
> +
> +static int
> +do_test_futex_writev (void)

do_test_futex_waitv? :)

> +{
> +  uint32_t word = 5;
> +  struct futex_waiter waiter =
> +    { .val = 4,
> +      .uaddr = (uintptr_t) &word,
> +      .flags = FUTEX2_SIZE_U32 | FUTEX2_PRIVATE
> +    };
> +
> +  /* Use a value mismatch to probe for kernel support (Linux 5.16).  */
> +  {
> +    int r = futex_waitv (&waiter, 1, 0, NULL, CLOCK_MONOTONIC);
> +    TEST_COMPARE (r, -1);
> +    if (errno == ENOSYS)
> +      FAIL_UNSUPPORTED ("kernel does not support the futex_waitv syscall");
> +    TEST_COMPARE (errno, EAGAIN);
> +  }
> +
> +  /* Nonzero syscall flags are rejected by the kernel.  */
> +  TEST_COMPARE (futex_waitv (&waiter, 1, ~0u, NULL, CLOCK_MONOTONIC), -1);
> +  TEST_COMPARE (errno, EINVAL);
> +
> +  /* Invalid number of waiters and invalid per-waiter flags.  */
> +  TEST_COMPARE (futex_waitv (&waiter, 0, 0, NULL, CLOCK_MONOTONIC), -1);
> +  TEST_COMPARE (errno, EINVAL);
> +  TEST_COMPARE (futex_waitv (&waiter, FUTEX_WAITV_MAX + 1, 0, NULL,
> +			     CLOCK_MONOTONIC), -1);
> +  TEST_COMPARE (errno, EINVAL);
> +  {
> +    struct futex_waiter bad =
> +      { .val = 5, .uaddr = (uintptr_t) &word, .flags = ~0u };
> +    TEST_COMPARE (futex_waitv (&bad, 1, 0, NULL, CLOCK_MONOTONIC), -1);
> +    TEST_COMPARE (errno, EINVAL);
> +  }
> +
> +  /* Invalid clock.  */
> +  {
> +    struct timespec ts = make_timespec (0, 0);
> +    waiter.val = 5;
> +    TEST_COMPARE (futex_waitv (&waiter, 1, 0, &ts, CLOCK_PROCESS_CPUTIME_ID),
> +		  -1);
> +    TEST_COMPARE (errno, EINVAL);
> +  }
> +
> +  /* Timeouts in the past, including negative tv_sec.  */
> +  {
> +    struct timespec ts = make_timespec (0, 0);
> +    TEST_COMPARE (futex_waitv (&waiter, 1, 0, &ts, CLOCK_MONOTONIC), -1);
> +    TEST_COMPARE (errno, ETIMEDOUT);
> +    ts = make_timespec (-1, 0);
> +    TEST_COMPARE (futex_waitv (&waiter, 1, 0, &ts, CLOCK_REALTIME), -1);
> +    TEST_COMPARE (errno, ETIMEDOUT);
> +  }
> +
> +  /* An actual short wait on both supported clocks.  */
> +  for (int i = 0; i < 2; i++)
> +    {
> +      clockid_t clockid = i == 0 ? CLOCK_REALTIME : CLOCK_MONOTONIC;
> +      struct timespec timeout
> +	= timespec_add (xclock_now (clockid), make_timespec (0, 100000000));
> +      TEST_COMPARE (futex_waitv (&waiter, 1, 0, &timeout, clockid), -1);
> +      TEST_COMPARE (errno, ETIMEDOUT);
> +      TEST_TIMESPEC_NOW_OR_AFTER (clockid, timeout);
> +    }
> +
> +  /* Block a thread on two futexes and wake it on the second one; the
> +     return value reports the index of the woken futex.  */
> +  {
> +    pthread_t thr = xpthread_create (NULL, waiter_tf, NULL);
> +
> +    while (__atomic_load_n (&waiter_result, __ATOMIC_ACQUIRE) == 0)
> +      futex_wake (&ftx2, INT_MAX, FUTEX2_PRIVATE);
> +    TEST_COMPARE (__atomic_load_n (&waiter_result, __ATOMIC_ACQUIRE), 1 + 1);
> +
> +    xpthread_join (thr);
> +  }
> +
> +  /* The same round-trip with process-shared futexes (no FUTEX2_PRIVATE)
> +     across processes, with the futex words in a shared mapping.  */
> +  {
> +    uint32_t *sftx = support_shared_allocate (3 * sizeof (uint32_t));
> +
> +    pid_t pid = xfork ();
> +    if (pid == 0)
> +      {
> +	struct futex_waiter waiters[] =
> +	  {
> +	    { .val = 0,
> +	      .uaddr = (uintptr_t) &sftx[0],
> +	      .flags = FUTEX2_SIZE_U32
> +	    },
> +	    { .val = 0,
> +	      .uaddr = (uintptr_t) &sftx[1],
> +	      .flags = FUTEX2_SIZE_U32
> +	    },
> +	  };
> +	int r;
> +	do
> +	  r = futex_waitv (waiters, 2, 0, NULL, CLOCK_MONOTONIC);
> +	while (r == -1 && errno == EINTR);
> +	if (r < 0)
> +	  _exit (2);
> +	__atomic_store_n (&sftx[2], r + 1, __ATOMIC_RELEASE);
> +	_exit (0);
> +      }
> +
> +    /* Wake the child on the second shared futex.  */
> +    while (__atomic_load_n (&sftx[2], __ATOMIC_ACQUIRE) == 0)
> +      futex_wake (&sftx[1], INT_MAX, 0);
> +    TEST_COMPARE (__atomic_load_n (&sftx[2], __ATOMIC_ACQUIRE), 1 + 1);
> +
> +    int status;
> +    xwaitpid (pid, &status, 0);
> +    TEST_VERIFY (WIFEXITED (status));
> +    TEST_COMPARE (WEXITSTATUS (status), 0);
> +
> +    support_shared_free (sftx);
> +  }
> +
> +  return 0;
> +}
> +
> +#endif
> +
> +static int
> +do_test (void)
> +{
> +#ifdef __USE_TIME_BITS64
> +  return do_test_futex_writev ();
> +#else
> +  FAIL_UNSUPPORTED ("futex_waitv is only declared when time_t is a "
> +		    "64-bit type (build with -D_TIME_BITS=64)");
> +#endif
> +}
> +
> +
> +#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 8ae243e974..831583c13d 100644
> --- a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
> @@ -2774,6 +2774,7 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F
>   GLIBC_2.5 __readlinkat_chk F
>   GLIBC_2.5 inet6_opt_append F
> diff --git a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
> index c9a00be076..ea5e23cf44 100644
> --- a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
> +++ b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
> @@ -2793,4 +2793,5 @@ GLIBC_2.43 umaxabs F
>   GLIBC_2.45 futex_requeue F
>   GLIBC_2.45 futex_timedwait F
>   GLIBC_2.45 futex_wait F
> +GLIBC_2.45 futex_waitv F
>   GLIBC_2.45 futex_wake F



More information about the Libc-alpha mailing list