This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
[patch] manual: nftw(); clarify FTW_SLN case
- From: DJ Delorie <dj at redhat dot com>
- To: libc-alpha at sourceware dot org
- Cc: codonell at redhat dot com
- Date: Tue, 21 Feb 2017 20:51:26 -0500
- Subject: [patch] manual: nftw(); clarify FTW_SLN case
- Authentication-results: sourceware.org; auth=none
Clarify that if FTW_PHYS is NOT passed, when a dangling symlink is
encountered, the callback can't use the stat info provided.
See: https://bugzilla.redhat.com/show_bug.cgi?id=1422736
diff --git a/manual/filesys.texi b/manual/filesys.texi
index edc7c64..c8c0425 100644
--- a/manual/filesys.texi
+++ b/manual/filesys.texi
@@ -938,7 +938,8 @@ visited and reported. This flag is returned instead of @code{FTW_D} if
the @code{FTW_DEPTH} flag is passed to @code{nftw} (see below).
@item FTW_SLN
The current item is a stale symbolic link. The file it points to does
-not exist.
+not exist. Note that the stat info pointed at by the second argument will
+be undefined in this case.
@end vtable
The last parameter of the callback function is a pointer to a structure
@@ -1087,7 +1088,9 @@ is @math{0} or a bitwise-OR combination of any of the following values.
While traversing the directory symbolic links are not followed. Instead
symbolic links are reported using the @code{FTW_SL} value for the type
parameter to the callback function. If the file referenced by a
-symbolic link does not exist @code{FTW_SLN} is returned instead.
+symbolic link does not exist @code{FTW_SLN} is returned instead. Note
+that if @code{FTW_PHYS} is @emph{not} passed, when @code{FTW_SLN} is
+passed to the callback, the stat data will not be defined.
@item FTW_MOUNT
The callback function is only called for items which are on the same
mounted filesystem as the directory given by the @var{filename}