.\"
.\" 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
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
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 ()
.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
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
.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/.