futex Linux system call

Let a thread sleep or wake waiters on a shared 32-bit word; mutexes use it when the userspace fast path cannot proceed.

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

Number on each ABI Linux 7.3

futex in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-642020xcasys_futexsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:214Open
i3862400xf0sys_futex_time32int 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:255Open
AArch64980x62sys_futexsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:126Open
ARM EABI2400xf0sys_futex_time32svc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:258Open
RISC-V 64980x62sys_futexecalla7a0, a1, a2, a3, a4, a5syscall.tbl:126Open
LoongArch 64980x62sys_futexsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:126Open
PowerPC 642210xddsys_futexscr0r3, r4, r5, r6, r7, r8syscall.tbl:282Open
PowerPC 322210xddsys_futex_time32scr0r3, r4, r5, r6, r7, r8syscall.tbl:281Open
IBM Z (s390x)2380xeesys_futexsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:195Open
MIPS o3242380x108esys_futex_time32syscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:252Open
MIPS n3261940x1832sys_futex_time32syscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:205Open
MIPS n6451940x144asys_futexsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:205Open

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(u32 __user *uaddr, int op, u32 val, const struct __kernel_timespec __user *utime, u32 __user *uaddr2, u32 val3);

x86-64, AArch64, RISC-V 64, LoongArch 64, PowerPC 64, IBM Z (s390x), MIPS n64 · Declaration: include/linux/syscalls.h:574

asmlinkage long sys_futex_time32(u32 __user *uaddr, int op, u32 val, const struct old_timespec32 __user *utime, u32 __user *uaddr2, u32 val3);

i386, ARM EABI, PowerPC 32, MIPS o32, MIPS n32 · Declaration: include/linux/syscalls.h:577

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

Manual page

futex(2)

Bundled kernel releases

Bundled releases whose tables define futex
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.155all 5
Linux 3.74all 4
Linux 3.03all 3
Linux 2.6.243all 3
Linux 2.6.163all 3
Linux 2.6.122all 2
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.