readahead Linux system call

Ask the kernel to preload a file range into the page cache.

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

Number on each ABI Linux 7.3

readahead in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-641870xbbsys_readaheadsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:199Open
i3862250xe1sys_ia32_readaheadint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:240Open
AArch642130xd5sys_readahead compat: compat_sys_readaheadsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:257Open
ARM EABI2250xe1sys_readahead OABI: sys_oabi_readaheadsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:243Open
RISC-V 642130xd5sys_readahead compat: compat_sys_readaheadecalla7a0, a1, a2, a3, a4, a5syscall.tbl:257Open
LoongArch 642130xd5sys_readahead compat: compat_sys_readaheadsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:257Open
PowerPC 641910xbfsys_readaheadscr0r3, r4, r5, r6, r7, r8syscall.tbl:250Open
PowerPC 321910xbfsys_ppc_readahead compat: compat_sys_ppc_readaheadscr0r3, r4, r5, r6, r7, r8syscall.tbl:249Open
IBM Z (s390x)2220xdesys_readaheadsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:180Open
MIPS o3242230x107fsys_readahead compat: sys32_readaheadsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:237Open
MIPS n3261790x1823sys_readaheadsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:190Open
MIPS n6451790x143bsys_readaheadsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:190Open

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_readahead(int fd, loff_t offset, size_t count);

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

asmlinkage long sys_ia32_readahead(int fd, unsigned int off_lo, unsigned int off_hi, size_t count);

i386 · Syscall definition: arch/x86/kernel/sys_ia32.c:98

long sys_ppc_readahead(int fd, u32 r4, u32 offset1, u32 offset2, u32 count);

PowerPC 32 · Declaration: arch/powerpc/include/asm/syscalls.h:99

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

Manual page

readahead(2)

Bundled kernel releases

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