userfaultfd Linux system call

Route selected page faults to userspace so a handler can resolve them.

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

Number on each ABI Linux 7.3

userfaultfd in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-643230x143sys_userfaultfdsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:335Open
i3863740x176sys_userfaultfdint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:389Open
AArch642820x11asys_userfaultfdsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:332Open
ARM EABI3880x184sys_userfaultfdsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:406Open
RISC-V 642820x11asys_userfaultfdecalla7a0, a1, a2, a3, a4, a5syscall.tbl:332Open
LoongArch 642820x11asys_userfaultfdsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:332Open
PowerPC 643640x16csys_userfaultfdscr0r3, r4, r5, r6, r7, r8syscall.tbl:470Open
PowerPC 323640x16csys_userfaultfdscr0r3, r4, r5, r6, r7, r8syscall.tbl:470Open
IBM Z (s390x)3550x163sys_userfaultfdsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:309Open
MIPS o3243570x1105sys_userfaultfdsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:371Open
MIPS n3263210x18b1sys_userfaultfdsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:332Open
MIPS n6453170x14c5sys_userfaultfdsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:328Open

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_userfaultfd(int flags);

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:949

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

Manual page

userfaultfd(2)

Bundled kernel releases

Bundled releases whose tables define userfaultfd
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.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.