[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