Mercurial > hg > octave-shane > gnulib-hg

annotate doc/posix-functions/faccessat.texi @ 12129:8e8f0292e99f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 <ebb9@byu.net>
author Eric Blake <ebb9@byu.net>
date Tue, 06 Oct 2009 13:57:50 -0600
parents 2cf208dc022b
children dc644566d7ab
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node faccessat
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{faccessat}
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex faccessat
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/faccessat.html}
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
11945
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
7 Gnulib module: faccessat
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 Portability problems fixed by Gnulib:
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
11945
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
11 @item
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
12 This function is missing on some platforms:
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
13 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
14 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
15 Interix 3.5, BeOS.
12129
8e8f0292e99f doc: tweak *at function documentation
Eric Blake <ebb9@byu.net>
parents: 11945
diff changeset
16 However, the replacement does not always take into account ACLs. Also,
8e8f0292e99f doc: tweak *at function documentation
Eric Blake <ebb9@byu.net>
parents: 11945
diff changeset
17 it is not safe to be used in libraries and is not multithread-safe.
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 @end itemize
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 Portability problems not fixed by Gnulib:
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 @itemize
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 @item
11945
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
23 There is an inherent race between calling this function and performing
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
24 some action based on the results; you should think twice before
2cf208dc022b faccessat: new module
Eric Blake <ebb9@byu.net>
parents: 10883
diff changeset
25 trusting this function in a set-uid or set-gid program.
10880
b1d6a7b9222f Document functions that have been added to POSIX:2008.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 @end itemize