[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