From 396ef4ef06e423ba882bbe65ad70ab0b06332a7b Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Tue, 6 Oct 2009 13:57:50 -0600 Subject: [PATCH] doc: tweak *at function documentation * doc/posix-functions/faccessat.texi (faccessat): Mention known issue with replacement. * doc/posix-functions/fchdir.texi (fchdir): Likewise. * doc/posix-functions/linkat.texi (linkat): Likewise. * doc/posix-functions/mkfifoat.texi (mkfifoat): Likewise. * doc/posix-functions/mknodat.texi (mknodat): Likewise. * doc/posix-functions/readlinkat.texi (readlinkat): Likewise. * doc/posix-functions/renameat.texi (renameat): Likewise. * doc/posix-functions/symlinkat.texi (symlinkat): Likewise. Signed-off-by: Eric Blake --- ChangeLog | 11 +++++++++++ doc/posix-functions/faccessat.texi | 3 ++- doc/posix-functions/fchdir.texi | 1 + doc/posix-functions/linkat.texi | 1 + doc/posix-functions/mkfifoat.texi | 1 + doc/posix-functions/mknodat.texi | 1 + doc/posix-functions/readlinkat.texi | 1 + doc/posix-functions/renameat.texi | 1 + doc/posix-functions/symlinkat.texi | 1 + 9 files changed, 20 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 05a473067..cc4b51d3f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,16 @@ 2009-10-06 Eric Blake + doc: tweak *at function documentation + * doc/posix-functions/faccessat.texi (faccessat): Mention + known issue with replacement. + * doc/posix-functions/fchdir.texi (fchdir): Likewise. + * doc/posix-functions/linkat.texi (linkat): Likewise. + * doc/posix-functions/mkfifoat.texi (mkfifoat): Likewise. + * doc/posix-functions/mknodat.texi (mknodat): Likewise. + * doc/posix-functions/readlinkat.texi (readlinkat): Likewise. + * doc/posix-functions/renameat.texi (renameat): Likewise. + * doc/posix-functions/symlinkat.texi (symlinkat): Likewise. + openat: fix GNU/Hurd bug in unlinkat * m4/openat.m4 (gl_FUNC_OPENAT): Replace unlinkat if unlink is broken. diff --git a/doc/posix-functions/faccessat.texi b/doc/posix-functions/faccessat.texi index 835a5d8db..f1d7be096 100644 --- a/doc/posix-functions/faccessat.texi +++ b/doc/posix-functions/faccessat.texi @@ -13,7 +13,8 @@ This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. -However, the replacement does not always take into account ACLs. +However, the replacement does not always take into account ACLs. Also, +it is not safe to be used in libraries and is not multithread-safe. @end itemize Portability problems not fixed by Gnulib: diff --git a/doc/posix-functions/fchdir.texi b/doc/posix-functions/fchdir.texi index 5283b6cce..06e99d812 100644 --- a/doc/posix-functions/fchdir.texi +++ b/doc/posix-functions/fchdir.texi @@ -11,6 +11,7 @@ Portability problems fixed by Gnulib: @item This function is missing on some platforms: Tandem/NSK, mingw, BeOS. +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: diff --git a/doc/posix-functions/linkat.texi b/doc/posix-functions/linkat.texi index 62fc43dc3..1fe5434e9 100644 --- a/doc/posix-functions/linkat.texi +++ b/doc/posix-functions/linkat.texi @@ -12,6 +12,7 @@ Portability problems fixed by Gnulib: This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. +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: diff --git a/doc/posix-functions/mkfifoat.texi b/doc/posix-functions/mkfifoat.texi index c3e39cade..2cd9f6f13 100644 --- a/doc/posix-functions/mkfifoat.texi +++ b/doc/posix-functions/mkfifoat.texi @@ -13,6 +13,7 @@ This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. +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: diff --git a/doc/posix-functions/mknodat.texi b/doc/posix-functions/mknodat.texi index d1af05861..6a6ed3fda 100644 --- a/doc/posix-functions/mknodat.texi +++ b/doc/posix-functions/mknodat.texi @@ -13,6 +13,7 @@ This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. +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: diff --git a/doc/posix-functions/readlinkat.texi b/doc/posix-functions/readlinkat.texi index 65f088fa5..4cef74368 100644 --- a/doc/posix-functions/readlinkat.texi +++ b/doc/posix-functions/readlinkat.texi @@ -12,6 +12,7 @@ Portability problems fixed by Gnulib: This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. +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: diff --git a/doc/posix-functions/renameat.texi b/doc/posix-functions/renameat.texi index 52f3921a6..ff08b09b2 100644 --- a/doc/posix-functions/renameat.texi +++ b/doc/posix-functions/renameat.texi @@ -21,6 +21,7 @@ This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 8, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. +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: diff --git a/doc/posix-functions/symlinkat.texi b/doc/posix-functions/symlinkat.texi index 7dd388719..d5ef9dca8 100644 --- a/doc/posix-functions/symlinkat.texi +++ b/doc/posix-functions/symlinkat.texi @@ -12,6 +12,7 @@ Portability problems fixed by Gnulib: This function is missing on some platforms: glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS. +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: -- 2.11.0