[PATCH 21/23] linux: Add kcmp

Adhemerval Zanella adhemerval.zanella@linaro.org
Tue Nov 3 14:32:26 GMT 2026


The kcmp system call (commit d97b46a64674a267bc41c9e16132ee2a98c3347d,
Linux 3.5) checks whether two processes share a kernel resource, such
as an open file description, the address space, or the file descriptor
table.  It is available independently of checkpoint/restore support
since Linux 5.12 (CONFIG_KCMP).

  int kcmp (pid_t pid1, pid_t pid2, int type, unsigned long int idx1,
	    unsigned long int idx2);

The new <sys/kcmp.h> header includes <linux/kcmp.h> if it is available
(it is since Linux 3.19), and otherwise defines the same enumeration and
structure.  The header name and prototype are the same used by systemd.

Some projects do use this syscall: Mesa, systemd, and CRIU.

Checked on x86_64-linux-gnu.
---
 NEWS                                          |   4 +
 sysdeps/unix/sysv/linux/Makefile              |   2 +
 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/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/sys/kcmp.h            |  73 ++++++++++++
 sysdeps/unix/sysv/linux/syscalls.list         |   1 +
 sysdeps/unix/sysv/linux/tst-kcmp.c            | 105 ++++++++++++++++++
 .../unix/sysv/linux/x86_64/64/libc.abilist    |   1 +
 .../unix/sysv/linux/x86_64/x32/libc.abilist   |   1 +
 38 files changed, 218 insertions(+)
 create mode 100644 sysdeps/unix/sysv/linux/sys/kcmp.h
 create mode 100644 sysdeps/unix/sysv/linux/tst-kcmp.c

diff --git a/NEWS b/NEWS
index b223daca5ab..4d9b78b7586 100644
--- a/NEWS
+++ b/NEWS
@@ -51,6 +51,10 @@ Major new features:
   with the <sys/ioprio.h> header.  They retrieve and set the I/O
   scheduling class and priority of processes.
 
+* On Linux, the kcmp function has been added, along with the <sys/kcmp.h>
+  header.  It checks whether two processes share a kernel resource, such
+  as an open file description or the address space.
+
 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 1cb7059686e..ff57fee384c 100644
--- a/sysdeps/unix/sysv/linux/Makefile
+++ b/sysdeps/unix/sysv/linux/Makefile
@@ -178,6 +178,7 @@ sysdep_headers += \
   sys/fsuid.h \
   sys/inotify.h \
   sys/ioprio.h \
+  sys/kcmp.h \
   sys/kd.h \
   sys/klog.h \
   sys/membarrier.h \
@@ -214,6 +215,7 @@ tests += \
   tst-gettid \
   tst-gettid-kill \
   tst-ioprio \
+  tst-kcmp \
   tst-linux-mremap1 \
   tst-membarrier \
   tst-memfd_create \
diff --git a/sysdeps/unix/sysv/linux/Versions b/sysdeps/unix/sysv/linux/Versions
index 73c35e3ef5b..6b3c413a6d4 100644
--- a/sysdeps/unix/sysv/linux/Versions
+++ b/sysdeps/unix/sysv/linux/Versions
@@ -350,6 +350,7 @@ libc {
     getxattrat;
     ioprio_get;
     ioprio_set;
+    kcmp;
     listmount;
     listxattrat;
     membarrier;
diff --git a/sysdeps/unix/sysv/linux/aarch64/libc.abilist b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
index ed6e15dad45..7b0a2397704 100644
--- a/sysdeps/unix/sysv/linux/aarch64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/aarch64/libc.abilist
@@ -2781,6 +2781,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/alpha/libc.abilist b/sysdeps/unix/sysv/linux/alpha/libc.abilist
index 06ad094d7d3..7440d4ea5c2 100644
--- a/sysdeps/unix/sysv/linux/alpha/libc.abilist
+++ b/sysdeps/unix/sysv/linux/alpha/libc.abilist
@@ -3128,6 +3128,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/arc/libc.abilist b/sysdeps/unix/sysv/linux/arc/libc.abilist
index 665e5882f0e..6cd569feea3 100644
--- a/sysdeps/unix/sysv/linux/arc/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arc/libc.abilist
@@ -2542,6 +2542,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/arm/be/libc.abilist b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
index 893a5225cbe..220925115c8 100644
--- a/sysdeps/unix/sysv/linux/arm/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/be/libc.abilist
@@ -2834,6 +2834,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/arm/le/libc.abilist b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
index 054cdb1098a..fcf578cff82 100644
--- a/sysdeps/unix/sysv/linux/arm/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/arm/le/libc.abilist
@@ -2831,6 +2831,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/csky/libc.abilist b/sysdeps/unix/sysv/linux/csky/libc.abilist
index 93a0d3b0658..4d4a86f5a4d 100644
--- a/sysdeps/unix/sysv/linux/csky/libc.abilist
+++ b/sysdeps/unix/sysv/linux/csky/libc.abilist
@@ -2818,6 +2818,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/hppa/libc.abilist b/sysdeps/unix/sysv/linux/hppa/libc.abilist
index 1102a7555cd..8d12d802c55 100644
--- a/sysdeps/unix/sysv/linux/hppa/libc.abilist
+++ b/sysdeps/unix/sysv/linux/hppa/libc.abilist
@@ -2855,6 +2855,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/i386/libc.abilist b/sysdeps/unix/sysv/linux/i386/libc.abilist
index f31848dc100..6e652795dea 100644
--- a/sysdeps/unix/sysv/linux/i386/libc.abilist
+++ b/sysdeps/unix/sysv/linux/i386/libc.abilist
@@ -3038,6 +3038,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
index fc6268c80b5..6f7bd790652 100644
--- a/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/ilp32/libc.abilist
@@ -2293,6 +2293,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
index c3d473048ef..275eaed7ad1 100644
--- a/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/loongarch/lp64/libc.abilist
@@ -2302,6 +2302,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
index 4e01878808e..483ddbbaf44 100644
--- a/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/coldfire/libc.abilist
@@ -2814,6 +2814,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
index cfe4501e8d9..ee151404ebe 100644
--- a/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
+++ b/sysdeps/unix/sysv/linux/m68k/m680x0/libc.abilist
@@ -2981,6 +2981,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
index 754439a8d6b..b25d96d35ea 100644
--- a/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/be/libc.abilist
@@ -2867,6 +2867,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
index a461625b47c..ec896a3c5f5 100644
--- a/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/microblaze/le/libc.abilist
@@ -2864,6 +2864,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
index 41f2c65dfd4..d83b83fd820 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/fpu/libc.abilist
@@ -2944,6 +2944,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
index 7690c7f5ef8..f481286283e 100644
--- a/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips32/nofpu/libc.abilist
@@ -2942,6 +2942,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
index 808e98d3c2b..23747992b1f 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n32/libc.abilist
@@ -2950,6 +2950,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
index 7440bcf0106..61dc7c9b01f 100644
--- a/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/mips/mips64/n64/libc.abilist
@@ -2852,6 +2852,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/or1k/libc.abilist b/sysdeps/unix/sysv/linux/or1k/libc.abilist
index 3b1d40cd8fb..9f9741283a4 100644
--- a/sysdeps/unix/sysv/linux/or1k/libc.abilist
+++ b/sysdeps/unix/sysv/linux/or1k/libc.abilist
@@ -2292,6 +2292,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
index e80833183cf..1c7889e9e6d 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/fpu/libc.abilist
@@ -3171,6 +3171,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
index d435a698639..f0da189de41 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc32/nofpu/libc.abilist
@@ -3216,6 +3216,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
index 92545f60903..90b64a92269 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/be/libc.abilist
@@ -2925,6 +2925,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
index 35cf64bca41..b0529357fc5 100644
--- a/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/powerpc/powerpc64/le/libc.abilist
@@ -3001,6 +3001,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
index ad4b8e47e3e..0c23eb13589 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv32/libc.abilist
@@ -2545,6 +2545,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
index 09d17b8bacb..2cc2b986e70 100644
--- a/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/riscv/rv64/libc.abilist
@@ -2745,6 +2745,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/s390/libc.abilist b/sysdeps/unix/sysv/linux/s390/libc.abilist
index 529c7f8aab5..71e6abd28da 100644
--- a/sysdeps/unix/sysv/linux/s390/libc.abilist
+++ b/sysdeps/unix/sysv/linux/s390/libc.abilist
@@ -2962,6 +2962,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/sh/be/libc.abilist b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
index 6d67cbc02c8..ae173346f86 100644
--- a/sysdeps/unix/sysv/linux/sh/be/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/be/libc.abilist
@@ -2861,6 +2861,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/sh/le/libc.abilist b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
index d01f775bba2..12d2d7bfb4c 100644
--- a/sysdeps/unix/sysv/linux/sh/le/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sh/le/libc.abilist
@@ -2858,6 +2858,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
index 5ff26b9299d..829f47c3212 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc32/libc.abilist
@@ -3192,6 +3192,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
index f6493956e0e..48322991ded 100644
--- a/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/sparc/sparc64/libc.abilist
@@ -2828,6 +2828,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/sys/kcmp.h b/sysdeps/unix/sysv/linux/sys/kcmp.h
new file mode 100644
index 00000000000..310b83fad19
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/sys/kcmp.h
@@ -0,0 +1,73 @@
+/* Compare kernel resources of processes.  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_KCMP_H
+#define _SYS_KCMP_H	1
+
+#include <features.h>
+#include <bits/types.h>
+
+#ifdef __has_include
+# if __has_include ("linux/kcmp.h")
+#  include "linux/kcmp.h"
+# endif
+#endif
+
+#ifndef _LINUX_KCMP_H
+/* Types of kernel resources compared by kcmp.  */
+enum kcmp_type
+{
+  KCMP_FILE,
+  KCMP_VM,
+  KCMP_FILES,
+  KCMP_FS,
+  KCMP_SIGHAND,
+  KCMP_IO,
+  KCMP_SYSVSEM,
+  KCMP_EPOLL_TFD,
+
+  KCMP_TYPES
+};
+
+/* Target file of an epoll set, for KCMP_EPOLL_TFD.  */
+struct kcmp_epoll_slot
+{
+  __uint32_t efd;	/* Epoll file descriptor.  */
+  __uint32_t tfd;	/* Target file descriptor number.  */
+  __uint32_t toff;	/* Target offset within the same numbered
+			   sequence.  */
+};
+#endif /* !_LINUX_KCMP_H */
+
+__BEGIN_DECLS
+
+/* Compare the kernel resource of type TYPE (one of the KCMP_* values) used by
+   the process PID1 with the one used by the process PID2.  For KCMP_FILE,
+   IDX1 and IDX2 are file descriptors of the processes; for KCMP_EPOLL_TFD,
+   IDX1 is a file descriptor of PID1 and IDX2 points to a
+   struct kcmp_epoll_slot describing a target file registered in an epoll
+   set of PID2.
+   Return 0 if the resources are the same, 1 or 2 if the first one is
+   respectively less or greater than the second one (in an arbitrary
+   ordering), or -1 and set errno on failure.  */
+extern int kcmp (__pid_t __pid1, __pid_t __pid2, int __type,
+		 unsigned long int __idx1, unsigned long int __idx2) __THROW;
+
+__END_DECLS
+
+#endif /* sys/kcmp.h */
diff --git a/sysdeps/unix/sysv/linux/syscalls.list b/sysdeps/unix/sysv/linux/syscalls.list
index c781d9a77e4..6fc1a0db80c 100644
--- a/sysdeps/unix/sysv/linux/syscalls.list
+++ b/sysdeps/unix/sysv/linux/syscalls.list
@@ -36,6 +36,7 @@ ioperm		-	ioperm		i:UUi	ioperm
 iopl		-	iopl		i:i	iopl
 ioprio_get	EXTRA	ioprio_get	i:ii	ioprio_get
 ioprio_set	EXTRA	ioprio_set	i:iii	ioprio_set
+kcmp		EXTRA	kcmp		i:iiiUU	kcmp
 klogctl		EXTRA	syslog		i:isi	klogctl
 lchown		-	lchown		i:sii	__lchown	lchown
 membarrier	EXTRA	membarrier	i:iUi	membarrier
diff --git a/sysdeps/unix/sysv/linux/tst-kcmp.c b/sysdeps/unix/sysv/linux/tst-kcmp.c
new file mode 100644
index 00000000000..ef7d024bec5
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/tst-kcmp.c
@@ -0,0 +1,105 @@
+/* Basic tests for Linux kcmp.
+   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 <stdint.h>
+#include <sys/epoll.h>
+#include <sys/kcmp.h>
+#include <sys/wait.h>
+#include <unistd.h>
+#include <support/check.h>
+#include <support/xunistd.h>
+
+static int
+do_test (void)
+{
+  pid_t pid = getpid ();
+  int fd1 = xopen ("/dev/null", O_RDONLY, 0);
+
+  int r = kcmp (pid, pid, KCMP_FILE, fd1, fd1);
+  if (r == -1 && errno == ENOSYS)
+    FAIL_UNSUPPORTED ("kcmp is not supported by the kernel");
+  TEST_COMPARE (r, 0);
+
+  /* A duplicated descriptor refers to the same open file description.  */
+  int fd2 = xdup (fd1);
+  TEST_COMPARE (kcmp (pid, pid, KCMP_FILE, fd1, fd2), 0);
+
+  /* A new open creates a new one, and the result orders both.  */
+  int fd3 = xopen ("/dev/null", O_RDONLY, 0);
+  r = kcmp (pid, pid, KCMP_FILE, fd1, fd3);
+  TEST_VERIFY (r == 1 || r == 2);
+  TEST_COMPARE (kcmp (pid, pid, KCMP_FILE, fd3, fd1), 3 - r);
+
+  TEST_COMPARE (kcmp (pid, pid, KCMP_VM, 0, 0), 0);
+  TEST_COMPARE (kcmp (pid, pid, KCMP_FILES, 0, 0), 0);
+
+  /* Check if kcmp and file descriptor child sharing.  */
+  int pipefd[2];
+  xpipe (pipefd);
+  pid_t child = xfork ();
+  if (child == 0)
+    {
+      char c;
+      xclose (pipefd[1]);
+      /* Wait until the parent closes the write end of the pipe.  */
+      TEST_COMPARE (read (pipefd[0], &c, 1), 0);
+      _exit (0);
+    }
+  TEST_COMPARE (kcmp (pid, child, KCMP_FILE, fd1, fd1), 0);
+  TEST_VERIFY (kcmp (pid, child, KCMP_VM, 0, 0) != 0);
+  TEST_VERIFY (kcmp (pid, child, KCMP_FILES, 0, 0) != 0);
+
+  /* Compare a file with the target file of an epoll set.  */
+  int efd = epoll_create1 (EPOLL_CLOEXEC);
+  TEST_VERIFY_EXIT (efd != -1);
+  struct epoll_event ev = { .events = EPOLLIN };
+  TEST_COMPARE (epoll_ctl (efd, EPOLL_CTL_ADD, pipefd[0], &ev), 0);
+  struct kcmp_epoll_slot slot =
+  {
+    .efd = efd,
+    .tfd = pipefd[0],
+  };
+  TEST_COMPARE (kcmp (pid, pid, KCMP_EPOLL_TFD, pipefd[0],
+		      (uintptr_t) &slot), 0);
+  TEST_VERIFY (kcmp (pid, pid, KCMP_EPOLL_TFD, fd1, (uintptr_t) &slot) != 0);
+
+  TEST_COMPARE (kcmp (pid, pid, KCMP_FILE, fd1, -1), -1);
+  TEST_COMPARE (errno, EBADF);
+  TEST_COMPARE (kcmp (pid, pid, KCMP_TYPES, 0, 0), -1);
+  TEST_COMPARE (errno, EINVAL);
+
+  xclose (pipefd[1]);
+  int status;
+  xwaitpid (child, &status, 0);
+  TEST_VERIFY (WIFEXITED (status) && WEXITSTATUS (status) == 0);
+
+  /* The child no longer exists.  */
+  TEST_COMPARE (kcmp (pid, child, KCMP_VM, 0, 0), -1);
+  TEST_COMPARE (errno, ESRCH);
+
+  xclose (efd);
+  xclose (pipefd[0]);
+  xclose (fd3);
+  xclose (fd2);
+  xclose (fd1);
+  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 7295fc43e43..c2e320d4e03 100644
--- a/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/64/libc.abilist
@@ -2777,6 +2777,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
diff --git a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
index 7cd21364349..91650b87f68 100644
--- a/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
+++ b/sysdeps/unix/sysv/linux/x86_64/x32/libc.abilist
@@ -2796,6 +2796,7 @@ GLIBC_2.45 file_setattr F
 GLIBC_2.45 getxattrat F
 GLIBC_2.45 ioprio_get F
 GLIBC_2.45 ioprio_set F
+GLIBC_2.45 kcmp F
 GLIBC_2.45 listmount F
 GLIBC_2.45 listxattrat F
 GLIBC_2.45 membarrier F
-- 
2.53.0



More information about the Libc-alpha mailing list