OSDN Git Service

(split) LDP: Update original to LDP v3.65
[linuxjm/LDP_man-pages.git] / original / man3 / fts.3
index 73b68b8..6be6d7b 100644 (file)
@@ -37,7 +37,7 @@
 .\"
 .\" 2007-12-08, mtk, Converted from mdoc to man macros
 .\"
-.TH FTS 3 2012-10-25 "Linux" "Linux Programmer's Manual"
+.TH FTS 3 2014-03-18 "Linux" "Linux Programmer's Manual"
 .SH NAME
 fts, fts_open, fts_read, fts_children, fts_set, fts_close \- \
 traverse a file hierarchy
@@ -373,8 +373,7 @@ The
 function takes a pointer to an array of character pointers naming one
 or more paths which make up a logical file hierarchy to be traversed.
 The array must be terminated by a
-NULL
-pointer.
+null pointer.
 .PP
 There are
 a number of options, at least one of which (either
@@ -587,7 +586,7 @@ field of the
 structure, and is ordered by the user-specified comparison function, if any.
 Repeated calls to
 .BR fts_children ()
-will recreate this linked list.
+will re-create this linked list.
 .PP
 As a special case, if
 .BR fts_read ()
@@ -697,7 +696,7 @@ fields of the structure, when returned by
 .BR fts_read (),
 will reflect the target of the symbolic link instead of the symbolic link
 itself.
-In either case, if the target of the symbolic link does not exist the
+In either case, if the target of the symbolic link does not exist, the
 fields of the returned structure will be unchanged and the
 .I fts_info
 field will be set to
@@ -775,6 +774,12 @@ The options were invalid.
 These functions are available in Linux since glibc2.
 .SH CONFORMING TO
 4.4BSD.
+.SH BUGS
+All of the APIs described in this man page are not safe when compiling
+a program using the LFS APIs (e.g., when compiling with
+.IR -D_FILE_OFFSET_BITS=64 ).
+.\" https://sourceware.org/bugzilla/show_bug.cgi?id=15838
+.\" https://sourceware.org/bugzilla/show_bug.cgi?id=11460
 .\" The following statement is years old, and seems no closer to
 .\" being true -- mtk
 .\" The
@@ -788,3 +793,11 @@ These functions are available in Linux since glibc2.
 .BR stat (2),
 .BR ftw (3),
 .BR qsort (3)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.