futex_waitv Linux system call

Wait until a wakeup occurs on any of several futex words.

In Linux 7.3, futex_waitv is defined in the system call table of 12 of the 12 bundled ABIs.

Number on each ABI Linux 7.3

futex_waitv in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-644490x1c1sys_futex_waitvsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:376Open
i3864490x1c1sys_futex_waitvint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:457Open
AArch644490x1c1sys_futex_waitvsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:392Open
ARM EABI4490x1c1sys_futex_waitvsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:466Open
RISC-V 644490x1c1sys_futex_waitvecalla7a0, a1, a2, a3, a4, a5syscall.tbl:392Open
LoongArch 644490x1c1sys_futex_waitvsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:392Open
PowerPC 644490x1c1sys_futex_waitvscr0r3, r4, r5, r6, r7, r8syscall.tbl:542Open
PowerPC 324490x1c1sys_futex_waitvscr0r3, r4, r5, r6, r7, r8syscall.tbl:542Open
IBM Z (s390x)4490x1c1sys_futex_waitvsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:378Open
MIPS o3244490x1161sys_futex_waitvsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:439Open
MIPS n3264490x1931sys_futex_waitvsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:390Open
MIPS n6454490x1549sys_futex_waitvsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:366Open

Argument locations are the ABI’s calling convention for ARG1–ARG6 in order, not an assignment made for this call. On 32-bit ABIs, 64-bit values may occupy multiple registers and require alignment; assembly wrappers may reorder them. See syscall(2). A table entry does not mean the call exists in every kernel: most optional calls return ENOSYS when the matching configuration option or architecture support is not built.

Kernel declaration

asmlinkage long sys_futex_waitv(struct futex_waitv __user *waiters, unsigned int nr_futexes, unsigned int flags, struct __kernel_timespec __user *timeout, clockid_t clockid);

x86-64, i386, AArch64, ARM EABI, RISC-V 64, LoongArch 64, PowerPC 64, PowerPC 32, IBM Z (s390x), MIPS o32, MIPS n32, MIPS n64 · Declaration: include/linux/syscalls.h:586

Signatures are kernel declarations and may differ from the C library wrappers.

Manual page

futex_waitv(2)

Bundled kernel releases

Bundled releases whose tables define futex_waitv
ReleaseABIs bundledDefined in the table of
Linux 7.312all 12
Linux 6.1812all 12
Linux 6.1212all 12
Linux 6.612all 12
Linux 5.1912all 12
Linux 4.155none
Linux 3.74none
Linux 3.03none
Linux 2.6.243none
Linux 2.6.163none
Linux 2.6.122none
Linux 1.01none

Each release is a separate snapshot, and older releases bundle fewer ABIs. This table does not claim the release in which the call first appeared. Numbers are listed where a release differs from Linux 7.3.