[PATCH v2 17/25] linux: Add file_getattr and file_setattr

Adhemerval Zanella adhemerval.zanella@linaro.org
Tue Nov 10 15:10:01 GMT 2026


The file_getattr and file_setattr system calls (commit
be7efb2d20d67f334a7de2aef77ae6c69367e646, Linux 6.17) retrieve and
change the file attributes (the FS_XFLAG_* flags, project ID, and
extent size hints) of a file.  They were previously only available
through the FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR ioctls, which
require an open file.

  int file_getattr (int dfd, const char *path, struct file_attr *fattr,
		    size_t size, unsigned int at_flags);
  int file_setattr (int dfd, const char *path,
		    const struct file_attr *fattr, size_t size,
		    unsigned int at_flags);

AT_FLAGS can contain AT_SYMLINK_NOFOLLOW and AT_EMPTY_PATH, and with
AT_EMPTY_PATH the path can also be a null pointer.  SIZE is the size
of the extensible struct file_attr.

The kernel defines struct file_attr and the FS_XFLAG_* constants in
<linux/fs.h>, which is commonly included along with <fcntl.h>, so
defining them in an existing glibc header would conflict with it.  The
new <sys/file_attr.h> header includes <linux/fs.h> if it is available
(as <sys/mount.h> does with <linux/mount.h>), defines struct file_attr
only if the kernel header does not provide it, and provides the
FS_XFLAG_* and FILE_ATTR_SIZE_* constants following the kernel
definitions.

Checked on x86_64-linux-gnu.
---
 NEWS                                          |  6 ++
 sysdeps/unix/sysv/linux/Makefile              |  2 +
 sysdeps/unix/sysv/linux/Versions              |  2 +
 sysdeps/unix/sysv/linux/aarch64/libc.abilist  |  2 +
 sysdeps/unix/sysv/linux/alpha/libc.abilist    |  2 +
 sysdeps/unix/sysv/linux/arc/libc.abilist      |  2 +
 sysdeps/unix/sysv/linux/arm/be/libc.abilist   |  2 +
 sysdeps/unix/sysv/linux/arm/le/libc.abilist   |  2 +
 sysdeps/unix/sysv/linux/csky/libc.abilist     |  2 +
 sysdeps/unix/sysv/linux/hppa/libc.abilist     |  2 +
 sysdeps/unix/sysv/linux/i386/libc.abilist     |  2 +
 .../sysv/linux/loongarch/ilp32/libc.abilist   |  2 +
 .../sysv/linux/loongarch/lp64/libc.abilist    |  2 +
 .../sysv/linux/m68k/coldfire/libc.abilist     |  2 +
 .../unix/sysv/linux/m68k/m680x0/libc.abilist  |  2 +
 .../sysv/linux/microblaze/be/libc.abilist     |  2 +
 .../sysv/linux/microblaze/le/libc.abilist     |  2 +
 .../sysv/linux/mips/mips32/fpu/libc.abilist   |  2 +
 .../sysv/linux/mips/mips32/nofpu/libc.abilist |  2 +
 .../sysv/linux/mips/mips64/n32/libc.abilist   |  2 +
 .../sysv/linux/mips/mips64/n64/libc.abilist   |  2 +
 sysdeps/unix/sysv/linux/or1k/libc.abilist     |  2 +
 .../linux/powerpc/powerpc32/fpu/libc.abilist  |  2 +
 .../powerpc/powerpc32/nofpu/libc.abilist      |  2 +
 .../linux/powerpc/powerpc64/be/libc.abilist   |  2 +
 .../linux/powerpc/powerpc64/le/libc.abilist   |  2 +
 .../unix/sysv/linux/riscv/rv32/libc.abilist   |  2 +
 .../unix/sysv/linux/riscv/rv64/libc.abilist   |  2 +
 sysdeps/unix/sysv/linux/s390/libc.abilist     |  2 +
 sysdeps/unix/sysv/linux/sh/be/libc.abilist    |  2 +
 sysdeps/unix/sysv/linux/sh/le/libc.abilist    |  2 +
 .../sysv/linux/sparc/sparc32/libc.abilist     |  2 +
 .../sysv/linux/sparc/sparc64/libc.abilist     |  2 +
 sysdeps/unix/sysv/linux/sys/file_attr.h       | 92 +++++++++++++++++++
 sysdeps/unix/sysv/linux/syscalls.list         |  2 +
 sysdeps/unix/sysv/linux/tst-file_attr.c       | 91 ++++++++++++++++++
 .../unix/sysv/linux/x86_64/64/libc.abilist    |  2 +
 .../unix/sysv/linux/x86_64/x32/libc.abilist   |  2 +
 38 files changed, 259 insertions(+)
 create mode 100644 sysdeps/unix/sysv/linux/sys/file_attr.h
 create mode 100644 sysdeps/unix/sysv/linux/tst-file_attr.c

diff --git a/NEWS b/NEWS
index 40d75379712..b810a80a0a9 100644
--- a/NEWS
+++ b/NEWS
@@ -33,6 +33,12 @@ Major new features:
   extended attribute functions which take a directory file descriptor
   and AT_* flags, like openat.
 
+* On Linux, the file_getattr and file_setattr functions have been added,
+  along with the <sys/file_attr.h> header.  They retrieve and change the
+  file attributes (FS_XFLAG_* flags, project ID, and extent size
+  hints) of a file, which were previously only available through the
+  FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR ioctls.
+
 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 f8f36875b62..3a89cad3927 100644
--- a/sysdeps/unix/sysv/linux/Makefile
+++ b/sysdeps/unix/sysv/linux/Makefile
@@ -175,6 +175,7 @@ sysdep_headers += \
   sys/epoll.h \
   sys/eventfd.h \
   sys/fanotify.h \
+  sys/file_attr.h \
   sys/fsuid.h \
   sys/inotify.h \
   sys/kd.h \
@@ -208,6 +209,7 @@ tests += \
   tst-fanotify \
   tst-fchroot \
   tst-fdopendir-o_path \
+  tst-file_attr \
   tst-getauxval \
   tst-gettid \
   tst-gettid-kill \
diff --git a/sysdeps/unix/sysv/linux/Versions b/sysdeps/unix/sysv/linux/Versions
index 0f79830fae6..43a50ceb024 100644
--- a/sysdeps/unix/sysv/linux/Versions
+++ b/sysdeps/unix/sysv/linux/Versions
@@ -345,6 +345,8 @@ libc {
   }
   GLIBC_2.45 {
     fchroot;
+    file_getattr;
+    file_setattr;
     getxattrat;
     listmount;
     listxattrat;
diff --git a/sysdeps/unix/sysv/linux/aarch64/libc.abilist b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
index a65de936403..d4da2f308a2 100644
--- a/sysdeps/unix/sysv/linux/aarch64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
@@ -2776,6 +2776,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/alpha/libc.abilist b/sysdeps/unix/sysv/linux/alpha/libc.abilist
index 5d8ef6ed469..8b8fbdc730b 100644
--- a/sysdeps/unix/sysv/linux/alpha/libc.abilist
+++ b/sysdeps/unix/sysv/linux/alpha/libc.abilist
@@ -3123,6 +3123,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/arc/libc.abilist b/sysdeps/unix/sysv/linux/arc/libc.abilist
index 54e5cda0a97..a2f8568a6a8 100644
--- a/sysdeps/unix/sysv/linux/arc/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arc/libc.abilist
@@ -2537,6 +2537,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/arm/be/libc.abilist b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
index 3d576527fba..e57b6b44895 100644
--- a/sysdeps/unix/sysv/linux/arm/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
@@ -2829,6 +2829,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/arm/le/libc.abilist b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
index 2ee3a4d24f8..63616f745e7 100644
--- a/sysdeps/unix/sysv/linux/arm/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
@@ -2826,6 +2826,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/csky/libc.abilist b/sysdeps/unix/sysv/linux/csky/libc.abilist
index 004aac045c9..cc4f333521e 100644
--- a/sysdeps/unix/sysv/linux/csky/libc.abilist
+++ b/sysdeps/unix/sysv/linux/csky/libc.abilist
@@ -2813,6 +2813,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/hppa/libc.abilist b/sysdeps/unix/sysv/linux/hppa/libc.abilist
index 26e410304e4..971c2b95bad 100644
--- a/sysdeps/unix/sysv/linux/hppa/libc.abilist
+++ b/sysdeps/unix/sysv/linux/hppa/libc.abilist
@@ -2850,6 +2850,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/i386/libc.abilist b/sysdeps/unix/sysv/linux/i386/libc.abilist
index 59a8ab3dc36..63353f56a33 100644
--- a/sysdeps/unix/sysv/linux/i386/libc.abilist
+++ b/sysdeps/unix/sysv/linux/i386/libc.abilist
@@ -3033,6 +3033,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
index 87a600b218b..49b96efbaf6 100644
--- a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
@@ -2288,6 +2288,8 @@ GLIBC_2.44 write F
 GLIBC_2.44 writev F
 GLIBC_2.44 wscanf F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
index 3191ecf202b..9e24eb6e1e4 100644
--- a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
@@ -2297,6 +2297,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
index 1b628d1cb70..928795ef474 100644
--- a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
@@ -2809,6 +2809,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
index 8df63f623cf..c4d2965a182 100644
--- a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
@@ -2976,6 +2976,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
index 70272410689..a13405293df 100644
--- a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
@@ -2862,6 +2862,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
index 62b39276f67..d03ae4855dc 100644
--- a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
@@ -2859,6 +2859,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
index a7807d455b4..97f251df3ae 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
@@ -2939,6 +2939,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
index 75beae5b876..3a5a8afa5c4 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
@@ -2937,6 +2937,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
index 1d46fc8cb01..b6271c34f7f 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
@@ -2945,6 +2945,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
index 7de9650f50f..8daff42f5e1 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
@@ -2847,6 +2847,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/or1k/libc.abilist b/sysdeps/unix/sysv/linux/or1k/libc.abilist
index a45ad084fc9..303f04c33e6 100644
--- a/sysdeps/unix/sysv/linux/or1k/libc.abilist
+++ b/sysdeps/unix/sysv/linux/or1k/libc.abilist
@@ -2287,6 +2287,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
index c57ddf5ece5..1b0e3364712 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
@@ -3166,6 +3166,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
index c911240e6de..4f292219b40 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
@@ -3211,6 +3211,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
index f2a1d91ee35..989467d0478 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
@@ -2920,6 +2920,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
index ccb60aed6ac..7f20ea0eff5 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
@@ -2996,6 +2996,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
index b6203449f3a..5afc9ce9a6d 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
@@ -2540,6 +2540,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
index 01c6cb97268..40296ea851d 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
@@ -2740,6 +2740,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/s390/libc.abilist b/sysdeps/unix/sysv/linux/s390/libc.abilist
index 09ea32971cf..985e551fa42 100644
--- a/sysdeps/unix/sysv/linux/s390/libc.abilist
+++ b/sysdeps/unix/sysv/linux/s390/libc.abilist
@@ -2957,6 +2957,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/sh/be/libc.abilist b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
index f11f7371b2f..c3f8eda6a49 100644
--- a/sysdeps/unix/sysv/linux/sh/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
@@ -2856,6 +2856,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/sh/le/libc.abilist b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
index 3ad79cc449f..6bbd688c3f8 100644
--- a/sysdeps/unix/sysv/linux/sh/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
@@ -2853,6 +2853,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
index 622bf32bdb7..b2912d0f9ac 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
@@ -3187,6 +3187,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
index 2a1ac0455f7..4fa81ef371a 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
@@ -2823,6 +2823,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/sys/file_attr.h b/sysdeps/unix/sysv/linux/sys/file_attr.h
new file mode 100644
index 00000000000..f63cac9d261
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/sys/file_attr.h
@@ -0,0 +1,92 @@
+/* File attributes.  Linux version.
+   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/>.  */
+
+#ifndef _SYS_FILE_ATTR_H
+#define _SYS_FILE_ATTR_H	1
+
+#include <features.h>
+#include <bits/types.h>
+#include <stddef.h>
+
+#ifdef __has_include
+# if __has_include ("linux/fs.h")
+#  include "linux/fs.h"
+# endif
+#endif
+
+#ifndef FILE_ATTR_SIZE_VER0
+/* Attributes for file_getattr and file_setattr.  */
+struct file_attr
+{
+  __uint64_t fa_xflags;		/* FS_XFLAG_* flags (get/set).  */
+  __uint32_t fa_extsize;	/* Extent size hint (get/set).  */
+  __uint32_t fa_nextents;	/* Number of extents (get).  */
+  __uint32_t fa_projid;		/* Project identifier (get/set).  */
+  __uint32_t fa_cowextsize;	/* CoW extent size hint (get/set).  */
+};
+# define FILE_ATTR_SIZE_VER0 24
+# define FILE_ATTR_SIZE_LATEST FILE_ATTR_SIZE_VER0
+#endif
+
+/* Flags for the fa_xflags field.  */
+#define FS_XFLAG_REALTIME	0x00000001	/* Data in realtime volume.  */
+#define FS_XFLAG_PREALLOC	0x00000002	/* Preallocated extents.  */
+#define FS_XFLAG_IMMUTABLE	0x00000008	/* File cannot be modified.  */
+#define FS_XFLAG_APPEND		0x00000010	/* All writes append.  */
+#define FS_XFLAG_SYNC		0x00000020	/* All writes synchronous.  */
+#define FS_XFLAG_NOATIME	0x00000040	/* No access time updates.  */
+#define FS_XFLAG_NODUMP		0x00000080	/* Not included in backups.  */
+#define FS_XFLAG_RTINHERIT	0x00000100	/* Create with rt bit set.  */
+#define FS_XFLAG_PROJINHERIT	0x00000200	/* Inherit parent projid.  */
+#define FS_XFLAG_NOSYMLINKS	0x00000400	/* No symlink creation.  */
+#define FS_XFLAG_EXTSIZE	0x00000800	/* Extent size hint.  */
+#define FS_XFLAG_EXTSZINHERIT	0x00001000	/* Inherit extent size.  */
+#define FS_XFLAG_NODEFRAG	0x00002000	/* Do not defragment.  */
+#define FS_XFLAG_FILESTREAM	0x00004000	/* Filestream allocator.  */
+#define FS_XFLAG_DAX		0x00008000	/* Use DAX for IO.  */
+#define FS_XFLAG_COWEXTSIZE	0x00010000	/* CoW extent size hint.  */
+#define FS_XFLAG_VERITY		0x00020000	/* fs-verity enabled.  */
+#define FS_XFLAG_CASEFOLD	0x00040000	/* Case-insensitive lookups
+						   (read-only).  */
+#define FS_XFLAG_CASENONPRESERVING 0x00080000	/* Case not preserved
+						   (read-only).  */
+#define FS_XFLAG_HASATTR	0x80000000	/* No DIFLAG for this.  */
+
+__BEGIN_DECLS
+
+/* The following functions operate on the file pointed to by PATH, which is
+   relative to the directory DFD (as openat).  AT_FLAGS can contain
+   AT_SYMLINK_NOFOLLOW and AT_EMPTY_PATH.  With AT_EMPTY_PATH, PATH can be
+   empty or a null pointer to operate on DFD itself.  SIZE is the size of
+   the structure pointed to by FATTR.  */
+
+/* Store in FATTR the attributes of the file.  Return 0 on success, -1 for
+   errors.  */
+extern int file_getattr (int __dfd, const char *__path,
+			 struct file_attr *__fattr, size_t __size,
+			 unsigned int __at_flags) __THROW;
+
+/* Set the attributes of the file to FATTR.  Return 0 on success, -1 for
+   errors.  */
+extern int file_setattr (int __dfd, const char *__path,
+			 const struct file_attr *__fattr, size_t __size,
+			 unsigned int __at_flags) __THROW;
+
+__END_DECLS
+
+#endif /* sys/file_attr.h */
diff --git a/sysdeps/unix/sysv/linux/syscalls.list b/sysdeps/unix/sysv/linux/syscalls.list
index c0c6ded4559..dfb270d3376 100644
--- a/sysdeps/unix/sysv/linux/syscalls.list
+++ b/sysdeps/unix/sysv/linux/syscalls.list
@@ -11,6 +11,8 @@ epoll_ctl	EXTRA	epoll_ctl	i:iiip	epoll_ctl
 eventfd		EXTRA	eventfd2	i:ii	eventfd
 execve		-	execve		i:spp	__execve	execve
 fchroot		EXTRA	fchroot		i:iU	fchroot
+file_getattr	EXTRA	file_getattr	i:iSpUU	file_getattr
+file_setattr	EXTRA	file_setattr	i:iSpUU	file_setattr
 flock		-	flock		i:ii	__flock		flock
 fsconfig	EXTRA	fsconfig	i:iUsNi	fsconfig
 fsmount		EXTRA	fsmount		i:iUU	fsmount
diff --git a/sysdeps/unix/sysv/linux/tst-file_attr.c b/sysdeps/unix/sysv/linux/tst-file_attr.c
new file mode 100644
index 00000000000..a15dbf68fbd
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/tst-file_attr.c
@@ -0,0 +1,91 @@
+/* Basic tests for Linux file_getattr and file_setattr.
+   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 <fcntl.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <sys/file_attr.h>
+#include <support/check.h>
+#include <support/temp_file.h>
+#include <support/xunistd.h>
+
+_Static_assert (sizeof (struct file_attr) >= FILE_ATTR_SIZE_VER0,
+		"sizeof (struct file_attr) < FILE_ATTR_SIZE_VER0");
+
+static int
+do_test (void)
+{
+  char *path;
+  int fd = create_temp_file ("tst-file_attr.", &path);
+  TEST_VERIFY_EXIT (fd != -1);
+
+  struct file_attr fa;
+  if (file_getattr (AT_FDCWD, path, &fa, sizeof (fa), 0) != 0)
+    {
+      /* The kernel does not fail with EPERM here, so it can only come
+	 from a seccomp filter.  */
+      if (errno == ENOSYS || errno == EPERM)
+	FAIL_UNSUPPORTED ("file_getattr is not available: %m");
+      if (errno == EOPNOTSUPP)
+	FAIL_UNSUPPORTED ("file attributes are not supported");
+      FAIL_EXIT1 ("file_getattr: %m");
+    }
+
+  /* The same attributes through the file descriptor.  */
+  struct file_attr fa2;
+  TEST_COMPARE (file_getattr (fd, NULL, &fa2, sizeof (fa2), AT_EMPTY_PATH),
+		0);
+  TEST_COMPARE (fa2.fa_xflags, fa.fa_xflags);
+
+  /* The structure size must cover the first version.  */
+  TEST_COMPARE (file_getattr (AT_FDCWD, path, &fa2, FILE_ATTR_SIZE_VER0 - 1,
+			      0), -1);
+  TEST_COMPARE (errno, EINVAL);
+
+  /* Only AT_SYMLINK_NOFOLLOW and AT_EMPTY_PATH are accepted.  */
+  TEST_COMPARE (file_getattr (AT_FDCWD, path, &fa2, sizeof (fa2),
+			      AT_REMOVEDIR), -1);
+  TEST_COMPARE (errno, EINVAL);
+
+  /* The owner of the file can set FS_XFLAG_NODUMP.  */
+  fa.fa_xflags |= FS_XFLAG_NODUMP;
+  if (file_setattr (AT_FDCWD, path, &fa, sizeof (fa), 0) == 0)
+    {
+      TEST_COMPARE (file_getattr (fd, "", &fa2, sizeof (fa2), AT_EMPTY_PATH),
+		    0);
+      TEST_VERIFY (fa2.fa_xflags & FS_XFLAG_NODUMP);
+
+      fa.fa_xflags &= ~FS_XFLAG_NODUMP;
+      TEST_COMPARE (file_setattr (fd, NULL, &fa, sizeof (fa), AT_EMPTY_PATH),
+		    0);
+      TEST_COMPARE (file_getattr (AT_FDCWD, path, &fa2, sizeof (fa2), 0), 0);
+      TEST_VERIFY (!(fa2.fa_xflags & FS_XFLAG_NODUMP));
+    }
+  else
+    {
+      TEST_COMPARE (errno, EOPNOTSUPP);
+      puts ("info: FS_XFLAG_NODUMP is not supported by the file system");
+    }
+
+  xclose (fd);
+  free (path);
+  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 6fa71624313..2f8d9816ad6 100644
--- a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
@@ -2772,6 +2772,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
diff --git a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
index 634a08ed5fb..bfd8e4db126 100644
--- a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
@@ -2791,6 +2791,8 @@ GLIBC_2.43 mseal F
 GLIBC_2.43 openat2 F
 GLIBC_2.43 umaxabs F
 GLIBC_2.45 fchroot F
+GLIBC_2.45 file_getattr F
+GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
-- 
2.53.0



More information about the Libc-alpha mailing list