diff options
-rw-r--r-- | ChangeLog | 7 | ||||
-rw-r--r-- | doc/posix-functions/fstatat.texi | 5 | ||||
-rw-r--r-- | doc/posix-functions/stat.texi | 5 |
3 files changed, 17 insertions, 0 deletions
@@ -1,2 +1,9 @@ +2024-04-19 Paul Eggert <eggert@cs.ucla.edu> + + fstatat, stat: document macOS st_ino pipe bug + * doc/posix-functions/fstatat.texi (fstatat): + * doc/posix-functions/stat.texi (stat): + Document macOS bug (see <https://bugs.gnu.org/70411>). + 2024-04-18 Bruno Haible <bruno@clisp.org> diff --git a/doc/posix-functions/fstatat.texi b/doc/posix-functions/fstatat.texi index e959a5cc73..90884e2eb1 100644 --- a/doc/posix-functions/fstatat.texi +++ b/doc/posix-functions/fstatat.texi @@ -41,4 +41,9 @@ on some platforms, even when @code{AT_EMPTY_PATH} is not used: glibc 2.7, Linux 2.6.38. @item +This function sets @code{st_ino} only to the low-order 32 bits of +the inode number of a socket or pipe, which thus can disagree +with the @code{st_ino} obtained by @code{fstat}: +macOS 14. +@item @xref{sys/stat.h}, for general portability problems with @code{struct stat}. @end itemize diff --git a/doc/posix-functions/stat.texi b/doc/posix-functions/stat.texi index f655451392..8afd3b17bb 100644 --- a/doc/posix-functions/stat.texi +++ b/doc/posix-functions/stat.texi @@ -51,4 +51,9 @@ Cygwin's @code{stat} function sometimes sets @code{errno} to @code{EACCES} when @code{ENOENT} would be more appropriate. @item +This function sets @code{st_ino} only to the low-order 32 bits of +the inode number of a socket or pipe, which thus can disagree +with the @code{st_ino} obtained by @code{fstat}: +macOS 14. +@item Because of the definition of @code{struct stat}, it is not possible to portably replace @code{stat} via an object-like macro. Therefore, |