cachestat Linux system call

Report page-cache activity for a file range, including cached and dirty pages.

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

Number on each ABI Linux 7.3

cachestat in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-644510x1c3sys_cachestatsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:378Open
i3864510x1c3sys_cachestatint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:459Open
AArch644510x1c3sys_cachestatsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:394Open
ARM EABI4510x1c3sys_cachestatsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:468Open
RISC-V 644510x1c3sys_cachestatecalla7a0, a1, a2, a3, a4, a5syscall.tbl:394Open
LoongArch 644510x1c3sys_cachestatsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:394Open
PowerPC 644510x1c3sys_cachestatscr0r3, r4, r5, r6, r7, r8syscall.tbl:544Open
PowerPC 324510x1c3sys_cachestatscr0r3, r4, r5, r6, r7, r8syscall.tbl:544Open
IBM Z (s390x)4510x1c3sys_cachestatsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:380Open
MIPS o3244510x1163sys_cachestatsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:441Open
MIPS n3264510x1933sys_cachestatsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:392Open
MIPS n6454510x154bsys_cachestatsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:368Open

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_cachestat(unsigned int fd, struct cachestat_range __user *cstat_range, struct cachestat __user *cstat, unsigned 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:999

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

Manual page

cachestat(2)

Bundled kernel releases

Bundled releases whose tables define cachestat
ReleaseABIs bundledDefined in the table of
Linux 7.312all 12
Linux 6.1812all 12
Linux 6.1212all 12
Linux 6.612all 12
Linux 5.1912none
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.