From: Bruno Haible Date: Wed, 30 Oct 2024 22:21:04 +0000 (+0100) Subject: futimes, utimensat, utimes, utime: Document Haiku malfunction. X-Git-Url: https://gitweb.git.savannah.gnu.org/gitweb/?a=commitdiff_plain;h=d4b580718f0323b12858c2b999f18217b964ac09;p=gnulib.git futimes, utimensat, utimes, utime: Document Haiku malfunction. * doc/posix-functions/futimens.texi: Mention Haiku's brokenness. * doc/posix-functions/utimensat.texi: Likewise. * doc/posix-functions/utimes.texi: Likewise. * doc/pastposix-functions/utime.texi: Likewise. --- diff --git a/ChangeLog b/ChangeLog index 6ce890f5cc..0ec82fec38 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2024-10-30 Bruno Haible + + futimes, utimensat, utimes, utime: Document Haiku malfunction. + * doc/posix-functions/futimens.texi: Mention Haiku's brokenness. + * doc/posix-functions/utimensat.texi: Likewise. + * doc/posix-functions/utimes.texi: Likewise. + * doc/pastposix-functions/utime.texi: Likewise. + 2024-10-30 Paul Eggert posix_memalign: check for GNU behavior with size 0 diff --git a/doc/pastposix-functions/utime.texi b/doc/pastposix-functions/utime.texi index d4eb86a882..b0d6eae6bd 100644 --- a/doc/pastposix-functions/utime.texi +++ b/doc/pastposix-functions/utime.texi @@ -36,6 +36,10 @@ Use @code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module @code{utimens}, instead. @item +This function sets a slightly different time stamp than the requested one: +@c https://dev.haiku-os.org/ticket/19215 +Haiku. +@item This function is removed in POSIX.1-2024. You can use Gnulib module @code{utimens} instead. @end itemize diff --git a/doc/posix-functions/futimens.texi b/doc/posix-functions/futimens.texi index 680d61eead..74c3301433 100644 --- a/doc/posix-functions/futimens.texi +++ b/doc/posix-functions/futimens.texi @@ -40,6 +40,10 @@ On file systems mounted with the @code{noatime} attribute, this function might not modify the access time as requested: Linux kernel 6.9. @item +This function sets a slightly different time stamp than the requested one: +@c https://dev.haiku-os.org/ticket/19212 +Haiku. +@item Some platforms lack the ability to change the timestamps of a file descriptor, so the replacement can fail with @code{ENOSYS}; @mindex utimens diff --git a/doc/posix-functions/utimensat.texi b/doc/posix-functions/utimensat.texi index 65f6d8d5de..2bb4230f55 100644 --- a/doc/posix-functions/utimensat.texi +++ b/doc/posix-functions/utimensat.texi @@ -49,6 +49,10 @@ On file systems mounted with the @code{noatime} attribute, this function might not modify the access time as requested: Linux kernel 6.9. @item +This function sets a slightly different time stamp than the requested one: +@c https://dev.haiku-os.org/ticket/19213 +Haiku. +@item On some platforms, timestamps of symbolic links cannot be modified, so the replacement fails with @code{ENOSYS} if passed the flag @code{AT_SYMLINK_NOFOLLOW} on a symlink. diff --git a/doc/posix-functions/utimes.texi b/doc/posix-functions/utimes.texi index 382adb9b0e..77142dee50 100644 --- a/doc/posix-functions/utimes.texi +++ b/doc/posix-functions/utimes.texi @@ -38,6 +38,10 @@ On some platforms, @code{utimes} failed on read-only files when @code{utime} worked fine. glibc 2.2.5. @item +This function sets a slightly different time stamp than the requested one: +@c https://dev.haiku-os.org/ticket/19214 +Haiku. +@item On OS/2, this function cannot set the timestamp to earlier than the year 1980 in local time. @item