fchdir.texi

Branch

Show log
Commit

Hash : 66080623
Author :
Date : 2025-01-10T10:34:58

doc: document some file system portability issues

* doc/glibc-functions/flistxattr.texi:
* doc/glibc-functions/listxattr.texi:
* doc/glibc-functions/llistxattr.texi:
* doc/posix-functions/fchdir.texi, doc/posix-functions/fstat.texi:
* doc/posix-functions/fstatvfs.texi:
Document some portability gotchas that Gnulib does not work around.

Download

doc/posix-functions/fchdir.texi

@node fchdir
@subsection @code{fchdir}
@findex fchdir

POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/functions/fchdir.html}

Gnulib module: fchdir
@mindex fchdir

Portability problems fixed by Gnulib:
@itemize
@item
This function is missing on some platforms:
mingw, MSVC 14.
But the replacement function is not safe to be used in libraries and is not multithread-safe.
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
This function fails if the file descriptor was opened with @code{O_PATH}:
Linux kernel 3.4.
@end itemize

Download

kc3-lang/gnulib/doc/posix-functions/fchdir.texi

Commit

doc/posix-functions/fchdir.texi