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
| ABI | No. | Hex | Entry point | Instruction | NR | Argument locations | Kernel table | Interactive view |
|---|---|---|---|---|---|---|---|---|
| x86-64 | 202 | 0xca | sys_futex | syscall | rax | rdi, rsi, rdx, r10, r8, r9 | syscall_64.tbl:214 | Open |
| i386 | 240 | 0xf0 | sys_futex_time32 | int 0x80 | eax | ebx, ecx, edx, esi, edi, ebp | syscall_32.tbl:255 | Open |
| AArch64 | 98 | 0x62 | sys_futex | svc #0 | x8 | x0, x1, x2, x3, x4, x5 | syscall.tbl:126 | Open |
| ARM EABI | 240 | 0xf0 | sys_futex_time32 | svc #0 | r7 | r0, r1, r2, r3, r4, r5 | syscall.tbl:258 | Open |
| RISC-V 64 | 98 | 0x62 | sys_futex | ecall | a7 | a0, a1, a2, a3, a4, a5 | syscall.tbl:126 | Open |
| LoongArch 64 | 98 | 0x62 | sys_futex | syscall 0 | a7 | a0, a1, a2, a3, a4, a5 | syscall.tbl:126 | Open |
| PowerPC 64 | 221 | 0xdd | sys_futex | sc | r0 | r3, r4, r5, r6, r7, r8 | syscall.tbl:282 | Open |
| PowerPC 32 | 221 | 0xdd | sys_futex_time32 | sc | r0 | r3, r4, r5, r6, r7, r8 | syscall.tbl:281 | Open |
| IBM Z (s390x) | 238 | 0xee | sys_futex | svc 0 | r1 | r2, r3, r4, r5, r6, r7 | syscall.tbl:195 | Open |
| MIPS o32 | 4238 | 0x108e | sys_futex_time32 | syscall | v0 | a0, a1, a2, a3, Stack (5), Stack (6) | syscall_o32.tbl:252 | Open |
| MIPS n32 | 6194 | 0x1832 | sys_futex_time32 | syscall | v0 | a0, a1, a2, a3, a4, a5 | syscall_n32.tbl:205 | Open |
| MIPS n64 | 5194 | 0x144a | sys_futex | syscall | v0 | a0, a1, a2, a3, a4, a5 | syscall_n64.tbl:205 | Open |
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
Bundled kernel releases
| Release | ABIs bundled | Defined in the table of |
|---|---|---|
| Linux 7.3 | 12 | all 12 |
| Linux 6.18 | 12 | all 12 |
| Linux 6.12 | 12 | all 12 |
| Linux 6.6 | 12 | all 12 |
| Linux 5.19 | 12 | all 12 |
| Linux 4.15 | 5 | all 5 |
| Linux 3.7 | 4 | all 4 |
| Linux 3.0 | 3 | all 3 |
| Linux 2.6.24 | 3 | all 3 |
| Linux 2.6.16 | 3 | all 3 |
| Linux 2.6.12 | 2 | all 2 |
| Linux 1.0 | 1 | none |
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.