[PATCH 23/23] linux: Add cachestat
Adhemerval Zanella
adhemerval.zanella@linaro.org
Tue Nov 3 14:32:28 GMT 2026
The cachestat system call (commit
cf264e1329fb0307e044f7675849f9f38b44c11a, Linux 6.5) returns the page
cache statistics of a byte range of a file.
int cachestat (int fd, const struct cachestat_range *cstat_range,
struct cachestat *cstat, unsigned int flags);
The structures are defined by <linux/mman.h>, which programs include
along with <sys/mman.h> in either order, and the kernel header does not
provide a macro to check for them. Defining them in <sys/mman.h> would
break programs that include <linux/mman.h> afterwards, so with
_GNU_SOURCE <sys/mman.h> now includes <linux/mman.h> if it is available
(as <sys/stat.h> does with <linux/stat.h> for statx), and only defines
them if the kernel header was not included.
The <asm/mman.h> definitions match the glibc ones, and both include
orders build without warnings with -Wall -Wextra on all supported ABIs.
With kernel headers older than Linux 6.5 the structures are only declared.
Somo Projects already call it through syscall: util-linux (fincore),
stress-ng, and LTP. The util-linux and LTP detect a cachestat function
at configure time and then expect the declarations from <sys/mman.h>.
The util-linux also builds with this change; LTP builds its cachestat
tests without _GNU_SOURCE, so it will need to define it.
Checked on x86_64-linux-gnu.
---
NEWS | 4 +
sysdeps/unix/sysv/linux/Makefile | 1 +
sysdeps/unix/sysv/linux/Versions | 1 +
sysdeps/unix/sysv/linux/aarch64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/alpha/libc.abilist | 1 +
sysdeps/unix/sysv/linux/arc/libc.abilist | 1 +
sysdeps/unix/sysv/linux/arm/be/libc.abilist | 1 +
sysdeps/unix/sysv/linux/arm/le/libc.abilist | 1 +
sysdeps/unix/sysv/linux/bits/mman_ext.h | 37 +++++
sysdeps/unix/sysv/linux/csky/libc.abilist | 1 +
sysdeps/unix/sysv/linux/hppa/libc.abilist | 1 +
sysdeps/unix/sysv/linux/i386/libc.abilist | 1 +
.../sysv/linux/loongarch/ilp32/libc.abilist | 1 +
.../sysv/linux/loongarch/lp64/libc.abilist | 1 +
.../sysv/linux/m68k/coldfire/libc.abilist | 1 +
.../unix/sysv/linux/m68k/m680x0/libc.abilist | 1 +
.../sysv/linux/microblaze/be/libc.abilist | 1 +
.../sysv/linux/microblaze/le/libc.abilist | 1 +
.../sysv/linux/mips/mips32/fpu/libc.abilist | 1 +
.../sysv/linux/mips/mips32/nofpu/libc.abilist | 1 +
.../sysv/linux/mips/mips64/n32/libc.abilist | 1 +
.../sysv/linux/mips/mips64/n64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/or1k/libc.abilist | 1 +
.../linux/powerpc/powerpc32/fpu/libc.abilist | 1 +
.../powerpc/powerpc32/nofpu/libc.abilist | 1 +
.../linux/powerpc/powerpc64/be/libc.abilist | 1 +
.../linux/powerpc/powerpc64/le/libc.abilist | 1 +
.../unix/sysv/linux/riscv/rv32/libc.abilist | 1 +
.../unix/sysv/linux/riscv/rv64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/s390/libc.abilist | 1 +
sysdeps/unix/sysv/linux/sh/be/libc.abilist | 1 +
sysdeps/unix/sysv/linux/sh/le/libc.abilist | 1 +
.../sysv/linux/sparc/sparc32/libc.abilist | 1 +
.../sysv/linux/sparc/sparc64/libc.abilist | 1 +
sysdeps/unix/sysv/linux/syscalls.list | 1 +
sysdeps/unix/sysv/linux/tst-cachestat.c | 156 ++++++++++++++++++
.../unix/sysv/linux/x86_64/64/libc.abilist | 1 +
.../unix/sysv/linux/x86_64/x32/libc.abilist | 1 +
38 files changed, 232 insertions(+)
create mode 100644 sysdeps/unix/sysv/linux/tst-cachestat.c
diff --git a/NEWS b/NEWS
index fba37064b38..5e391f41ccd 100644
--- a/NEWS
+++ b/NEWS
@@ -60,6 +60,10 @@ Major new features:
allowed to see, optionally only those of some types or owned by a user
namespace.
+* On Linux, the cachestat function has been added to <sys/mman.h>. It
+ returns the page cache statistics of a range of a file: the number of
+ cached, dirty, under writeback, and evicted pages.
+
Deprecated and removed features, and other changes affecting compatibility:
* The posix_spawn_file_actions_addchdir and posix_spawn_file_actions_addfchdir
diff --git a/sysdeps/unix/sysv/linux/Makefile b/sysdeps/unix/sysv/linux/Makefile
index 0a01dbbc8dd..b18110c1b2d 100644
--- a/sysdeps/unix/sysv/linux/Makefile
+++ b/sysdeps/unix/sysv/linux/Makefile
@@ -201,6 +201,7 @@ sysdep_headers += \
tests += \
test-errno-linux \
tst-adjtimex \
+ tst-cachestat \
tst-clock_adjtime \
tst-clone \
tst-clone2 \
diff --git a/sysdeps/unix/sysv/linux/Versions b/sysdeps/unix/sysv/linux/Versions
index f895742ccb3..b90b4c92019 100644
--- a/sysdeps/unix/sysv/linux/Versions
+++ b/sysdeps/unix/sysv/linux/Versions
@@ -344,6 +344,7 @@ libc {
openat2;
}
GLIBC_2.45 {
+ cachestat;
fchroot;
file_getattr;
file_setattr;
diff --git a/sysdeps/unix/sysv/linux/aarch64/libc.abilist b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
index 820f7dd3af9..d8edb73cae8 100644
--- a/sysdeps/unix/sysv/linux/aarch64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
@@ -2775,6 +2775,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/alpha/libc.abilist b/sysdeps/unix/sysv/linux/alpha/libc.abilist
index efa75065b83..5392320d16a 100644
--- a/sysdeps/unix/sysv/linux/alpha/libc.abilist
+++ b/sysdeps/unix/sysv/linux/alpha/libc.abilist
@@ -3122,6 +3122,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/arc/libc.abilist b/sysdeps/unix/sysv/linux/arc/libc.abilist
index bba3450c471..bc426caded6 100644
--- a/sysdeps/unix/sysv/linux/arc/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arc/libc.abilist
@@ -2536,6 +2536,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/arm/be/libc.abilist b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
index 7cc35a77ce0..ce8865d706f 100644
--- a/sysdeps/unix/sysv/linux/arm/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
@@ -2828,6 +2828,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/arm/le/libc.abilist b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
index 27043e24e95..4fa7dc1c863 100644
--- a/sysdeps/unix/sysv/linux/arm/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
@@ -2825,6 +2825,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/bits/mman_ext.h b/sysdeps/unix/sysv/linux/bits/mman_ext.h
index 19b09e00dd4..a373fd4d681 100644
--- a/sysdeps/unix/sysv/linux/bits/mman_ext.h
+++ b/sysdeps/unix/sysv/linux/bits/mman_ext.h
@@ -29,4 +29,41 @@ extern __ssize_t process_madvise (int __pid_fd, const struct iovec *__iov,
extern int process_mrelease (int pidfd, unsigned int flags) __THROW;
+# ifdef __has_include
+# if __has_include ("linux/mman.h")
+# include "linux/mman.h"
+# endif
+# endif
+
+# ifndef _LINUX_MMAN_H
+/* Byte range of the file queried by cachestat. A zero LEN means up to
+ the end of the file. */
+struct cachestat_range
+{
+ __uint64_t off;
+ __uint64_t len;
+};
+
+/* Page cache statistics returned by cachestat, in number of pages. */
+struct cachestat
+{
+ __uint64_t nr_cache;
+ __uint64_t nr_dirty;
+ __uint64_t nr_writeback;
+ __uint64_t nr_evicted;
+ __uint64_t nr_recently_evicted;
+};
+# endif
+
+/* Kernel headers older than Linux 6.5 do not define them. */
+struct cachestat_range;
+struct cachestat;
+
+/* Store in *CSTAT the page cache statistics of the file FD in the byte
+ range *CSTAT_RANGE. FLAGS must be zero. Return 0 on success, or -1
+ and set errno on failure. */
+extern int cachestat (int __fd, const struct cachestat_range *__cstat_range,
+ struct cachestat *__cstat, unsigned int __flags)
+ __THROW;
+
#endif /* __USE_GNU */
diff --git a/sysdeps/unix/sysv/linux/csky/libc.abilist b/sysdeps/unix/sysv/linux/csky/libc.abilist
index c3337d446f9..9ace889b143 100644
--- a/sysdeps/unix/sysv/linux/csky/libc.abilist
+++ b/sysdeps/unix/sysv/linux/csky/libc.abilist
@@ -2812,6 +2812,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/hppa/libc.abilist b/sysdeps/unix/sysv/linux/hppa/libc.abilist
index 850a617b062..cc7a616f756 100644
--- a/sysdeps/unix/sysv/linux/hppa/libc.abilist
+++ b/sysdeps/unix/sysv/linux/hppa/libc.abilist
@@ -2849,6 +2849,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/i386/libc.abilist b/sysdeps/unix/sysv/linux/i386/libc.abilist
index c43e1909095..497644fe045 100644
--- a/sysdeps/unix/sysv/linux/i386/libc.abilist
+++ b/sysdeps/unix/sysv/linux/i386/libc.abilist
@@ -3032,6 +3032,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
index f1fe8833e63..c8b5c611d7c 100644
--- a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
@@ -2287,6 +2287,7 @@ GLIBC_2.44 wprintf F
GLIBC_2.44 write F
GLIBC_2.44 writev F
GLIBC_2.44 wscanf F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
index ef94f919cf9..e231ce48489 100644
--- a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
@@ -2296,6 +2296,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
index df9abdee9e4..24450beb7a1 100644
--- a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
@@ -2808,6 +2808,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
index db713f2d8e7..2a08149ff0c 100644
--- a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
@@ -2975,6 +2975,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
index 25969831b41..9f108f082af 100644
--- a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
@@ -2861,6 +2861,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
index 7eed5d1ce88..d9f5c239b22 100644
--- a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
@@ -2858,6 +2858,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
index 19b28086025..e2bee38b5be 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
@@ -2938,6 +2938,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
index 07933e17c45..95c2a8dc355 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
@@ -2936,6 +2936,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
index 4febd2367c0..e5aaf40965f 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
@@ -2944,6 +2944,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
index 6ec1e694447..f90369b8140 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
@@ -2846,6 +2846,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/or1k/libc.abilist b/sysdeps/unix/sysv/linux/or1k/libc.abilist
index c58edc69ed3..234cd09b87a 100644
--- a/sysdeps/unix/sysv/linux/or1k/libc.abilist
+++ b/sysdeps/unix/sysv/linux/or1k/libc.abilist
@@ -2286,6 +2286,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
index 151ff28ddf7..6d3dc2f2db1 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
@@ -3165,6 +3165,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
index f277b58eb15..d299bf9dc71 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
@@ -3210,6 +3210,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
index 5fdcb443c07..23ae0da1230 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
@@ -2919,6 +2919,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
index 1341073d330..52b6f6da620 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
@@ -2995,6 +2995,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
index ea76179456e..21bb39510bb 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
@@ -2539,6 +2539,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
index 0ac55bf57f2..95807fbc358 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
@@ -2739,6 +2739,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/s390/libc.abilist b/sysdeps/unix/sysv/linux/s390/libc.abilist
index 7e669cd77b5..cf7e868268a 100644
--- a/sysdeps/unix/sysv/linux/s390/libc.abilist
+++ b/sysdeps/unix/sysv/linux/s390/libc.abilist
@@ -2956,6 +2956,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/sh/be/libc.abilist b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
index 3d3c9004fbd..993c1ff6c7b 100644
--- a/sysdeps/unix/sysv/linux/sh/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
@@ -2855,6 +2855,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/sh/le/libc.abilist b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
index 677a7a9d7b5..1aeef25680e 100644
--- a/sysdeps/unix/sysv/linux/sh/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
@@ -2852,6 +2852,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
index ff5a306551f..adc910eaa6a 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
@@ -3186,6 +3186,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
index d1b5b2f4c36..06d37a7ec7e 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
@@ -2822,6 +2822,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/syscalls.list b/sysdeps/unix/sysv/linux/syscalls.list
index 7d71492ab0d..093123e431f 100644
--- a/sysdeps/unix/sysv/linux/syscalls.list
+++ b/sysdeps/unix/sysv/linux/syscalls.list
@@ -2,6 +2,7 @@
alarm - alarm i:i alarm
bdflush EXTRA bdflush i:ii __compat_bdflush bdflush@GLIBC_2.0:GLIBC_2.23
+cachestat EXTRA cachestat i:ippU cachestat
capget EXTRA capget i:pp capget
capset EXTRA capset i:pp capset
create_module EXTRA create_module 3 __compat_create_module create_module@GLIBC_2.0:GLIBC_2.23
diff --git a/sysdeps/unix/sysv/linux/tst-cachestat.c b/sysdeps/unix/sysv/linux/tst-cachestat.c
new file mode 100644
index 00000000000..ae0d4e51b97
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/tst-cachestat.c
@@ -0,0 +1,156 @@
+/* Basic tests for Linux cachestat.
+ Copyright (C) 2026 Free Software Foundation, Inc.
+ This file is part of the GNU C Library.
+
+ The GNU C Library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ The GNU C Library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with the GNU C Library; if not, see
+ <https://www.gnu.org/licenses/>. */
+
+#include <errno.h>
+#include <inttypes.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sys/mman.h>
+#include <unistd.h>
+#include <support/check.h>
+#include <support/support.h>
+#include <support/temp_file.h>
+#include <support/xunistd.h>
+
+/* Kernel headers older than Linux 6.5 provide <linux/mman.h> without the
+ cachestat structures, which <sys/mman.h> then only declares, so use
+ copies of them. */
+struct test_cachestat_range
+{
+ uint64_t off;
+ uint64_t len;
+};
+
+struct test_cachestat
+{
+ uint64_t nr_cache;
+ uint64_t nr_dirty;
+ uint64_t nr_writeback;
+ uint64_t nr_evicted;
+ uint64_t nr_recently_evicted;
+};
+
+static int
+test_cachestat (int fd, const struct test_cachestat_range *range,
+ struct test_cachestat *cs, unsigned int flags)
+{
+ return cachestat (fd, (const struct cachestat_range *) range,
+ (struct cachestat *) cs, flags);
+}
+
+/* Number of pages written to the file. */
+enum { npages = 4 };
+
+static int fd;
+
+static struct test_cachestat
+query (uint64_t off, uint64_t len)
+{
+ struct test_cachestat_range range = { .off = off, .len = len };
+ struct test_cachestat cs;
+ /* Check that all the fields are written. */
+ memset (&cs, 0xff, sizeof (cs));
+ if (test_cachestat (fd, &range, &cs, 0) != 0)
+ FAIL_EXIT1 ("cachestat (%" PRIu64 ", %" PRIu64 "): %m", off, len);
+ TEST_VERIFY (cs.nr_dirty <= cs.nr_cache);
+ TEST_VERIFY (cs.nr_writeback <= cs.nr_cache);
+ TEST_VERIFY (cs.nr_recently_evicted <= cs.nr_evicted);
+ return cs;
+}
+
+static void
+check_range (uint64_t off, uint64_t len, uint64_t expected)
+{
+ struct test_cachestat cs = query (off, len);
+ if (cs.nr_cache + cs.nr_evicted != expected)
+ FAIL ("cachestat (%" PRIu64 ", %" PRIu64 "): nr_cache %llu"
+ " + nr_evicted %llu != %" PRIu64, off, len,
+ (unsigned long long int) cs.nr_cache,
+ (unsigned long long int) cs.nr_evicted, expected);
+}
+
+static int
+do_test (void)
+{
+ fd = create_temp_file ("tst-cachestat", NULL);
+ TEST_VERIFY_EXIT (fd != -1);
+
+ struct test_cachestat_range range = { 0 };
+ struct test_cachestat cs;
+ if (test_cachestat (fd, &range, &cs, 0) != 0)
+ {
+ if (errno == ENOSYS)
+ FAIL_UNSUPPORTED ("cachestat is not supported by the kernel");
+ FAIL_EXIT1 ("cachestat: %m");
+ }
+ /* The file is empty. */
+ TEST_COMPARE (cs.nr_cache, 0);
+ TEST_COMPARE (cs.nr_evicted, 0);
+
+ long int page_size = sysconf (_SC_PAGESIZE);
+ size_t size = npages * page_size;
+ char *buf = xmalloc (size);
+ memset (buf, 0x55, size);
+ xwrite (fd, buf, size);
+ free (buf);
+
+ /* The byte range is rounded to whole pages. */
+ check_range (0, size, npages);
+ check_range (page_size, 2 * page_size, 2);
+ check_range (page_size / 2, 1, 1);
+ check_range (page_size / 2, page_size, 2);
+ check_range ((npages - 1) * page_size, page_size, 1);
+
+ /* A zero length means up to the end of the file, but a large folio may
+ extend past it. */
+ cs = query (0, 0);
+ TEST_VERIFY (cs.nr_cache + cs.nr_evicted >= npages);
+
+ /* No page is dirty or under writeback after fsync. */
+ TEST_COMPARE (fsync (fd), 0);
+ cs = query (0, size);
+ TEST_COMPARE (cs.nr_dirty, 0);
+ TEST_COMPARE (cs.nr_writeback, 0);
+ TEST_COMPARE (cs.nr_cache + cs.nr_evicted, npages);
+
+ /* FLAGS must be zero. */
+ range.len = size;
+ TEST_COMPARE (test_cachestat (fd, &range, &cs, 1), -1);
+ TEST_COMPARE (errno, EINVAL);
+
+ TEST_COMPARE (test_cachestat (-1, &range, &cs, 0), -1);
+ TEST_COMPARE (errno, EBADF);
+
+ /* hugetlbfs is not supported. */
+ int hfd = memfd_create ("tst-cachestat", MFD_CLOEXEC | MFD_HUGETLB);
+ if (hfd == -1)
+ printf ("info: cannot create hugetlbfs file: %m\n");
+ else
+ {
+ TEST_COMPARE (test_cachestat (hfd, &range, &cs, 0), -1);
+ TEST_COMPARE (errno, EOPNOTSUPP);
+ xclose (hfd);
+ }
+
+ xclose (fd);
+ return 0;
+}
+
+#include <support/test-driver.c>
diff --git a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
index 34e8bfbe9dd..c30f6fa8472 100644
--- a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
@@ -2771,6 +2771,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
diff --git a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
index 951e75322c3..04077220eb6 100644
--- a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
@@ -2790,6 +2790,7 @@ GLIBC_2.43 memset_explicit F
GLIBC_2.43 mseal F
GLIBC_2.43 openat2 F
GLIBC_2.43 umaxabs F
+GLIBC_2.45 cachestat F
GLIBC_2.45 fchroot F
GLIBC_2.45 file_getattr F
GLIBC_2.45 file_setattr F
--
2.53.0
More information about the Libc-alpha
mailing list