summaryrefslogtreecommitdiff
path: root/doc/posix-functions/lstat.texi
diff options
context:
space:
mode:
authorBruno Haible <bruno@clisp.org>2008-01-20 00:09:59 +0100
committerBruno Haible <bruno@clisp.org>2008-01-20 00:09:59 +0100
commit2b6c08c775ae4e80b52aa41058ea5939f778b44b (patch)
treeac9d11e47616b23a9c4feb5e5a19468008b8a770 /doc/posix-functions/lstat.texi
parente606e4f86f58f108829f84777e565eebd0a467e7 (diff)
downloadgnulib-2b6c08c775ae4e80b52aa41058ea5939f778b44b.tar.gz
Rename two directories: headers -> posix-headers, functions -> posix-functions.
Diffstat (limited to 'doc/posix-functions/lstat.texi')
-rw-r--r--doc/posix-functions/lstat.texi25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/posix-functions/lstat.texi b/doc/posix-functions/lstat.texi
new file mode 100644
index 0000000000..e87dfa706d
--- /dev/null
+++ b/doc/posix-functions/lstat.texi
@@ -0,0 +1,25 @@
+@node lstat
+@section @code{lstat}
+@findex lstat
+
+POSIX specification: @url{http://www.opengroup.org/susv3xsh/lstat.html}
+
+Gnulib module: lstat
+
+Portability problems fixed by Gnulib:
+@itemize
+@item
+When the argument ends in a slash, some platforms don't dereference the
+argument.
+@item
+On Windows platforms (excluding Cygwin), symlinks are not supported, so
+@code{lstat} does not exist.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, @code{lstat} may not
+correctly report the size of files or block devices larger than 2 GB. The fix
+is to use the @code{AC_SYS_LARGEFILE} macro.
+@end itemize