[PATCH v2 5/5] manual: Document --enable-kernel=5.1 for CONFIG_COMPAT_32BIT_TIME=n

Arnd Bergmann arnd@kernel.org
Mon Nov 16 12:08:57 GMT 2026


From: Adhemerval Zanella <adhemerval.zanella@linaro.org>

On __TIMESIZE == 32 ABIs, glibc only avoids the time32 system calls
when __ASSUME_TIME64_SYSCALLS is set, i.e. with --enable-kernel=5.1.0 or
later.  With an older minimum kernel it still calls them whenever the
value fits in 32 bits, to avoid an ENOSYS round trip on kernels without
the time64 system calls.  Document this in NEWS and in the
--enable-kernel entry of the installation manual.

Signed-off-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Signed-off-by: Arnd Bergmann <arnd@arndb.de>
---
 INSTALL             | 5 +++++
 NEWS                | 6 +++++-
 manual/install.texi | 5 +++++
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/INSTALL b/INSTALL
index 0f3745d3b20f..de4bd71db76e 100644
--- a/INSTALL
+++ b/INSTALL
@@ -86,6 +86,11 @@ passed to 'configure'.  For example:
      expected to support.  The higher the VERSION number is, the less
      compatibility code is added, and the faster the code gets.
 
+     On 32-bit targets that still support a 32-bit 'time_t', such as
+     i386 and arm, a VERSION of 5.1.0 or later also makes the GNU C
+     Library use only the 64-bit time system calls.  This is required to
+     run on kernels built without 'CONFIG_COMPAT_32BIT_TIME'.
+
 '--with-binutils=DIRECTORY'
      Use the binutils (assembler and linker) in 'DIRECTORY', not the
      ones the C compiler would default to.  You can use this option if
diff --git a/NEWS b/NEWS
index eee1e44a9285..a53aab4ce8db 100644
--- a/NEWS
+++ b/NEWS
@@ -24,7 +24,11 @@ Deprecated and removed features, and other changes affecting compatibility:
 
 Changes to build and runtime requirements:
 
-  [Add changes to build and runtime requirements here]
+* On 32-bit targets that still support a 32-bit time_t, such as i386 and
+  arm, the library now uses only the 64-bit time system calls when it is
+  configured with --enable-kernel=5.1.0 or later.  Such a build can run
+  on Linux kernels built without CONFIG_COMPAT_32BIT_TIME.  With an older
+  minimum kernel version, the 32-bit time system calls are still used.
 
 Security related changes:
 
diff --git a/manual/install.texi b/manual/install.texi
index e2f45b8e6f55..b697ef3e3441 100644
--- a/manual/install.texi
+++ b/manual/install.texi
@@ -116,6 +116,11 @@ smallest version of the Linux kernel the generated library is expected
 to support.  The higher the @var{version} number is, the less
 compatibility code is added, and the faster the code gets.
 
+On 32-bit targets that still support a 32-bit @code{time_t}, such as
+i386 and arm, a @var{version} of 5.1.0 or later also makes @theglibc{}
+use only the 64-bit time system calls.  This is required to run on
+kernels built without @code{CONFIG_COMPAT_32BIT_TIME}.
+
 @item --with-binutils=@var{directory}
 Use the binutils (assembler and linker) in @file{@var{directory}}, not
 the ones the C compiler would default to.  You can use this option if
-- 
2.53.0



More information about the Libc-alpha mailing list