ftw.h - file tree traversal
[XSI] #include <ftw.h>
The <ftw.h> header shall define the FTW structure that includes at least the following members:int base int level
The <ftw.h> header shall define macros for use as values of the third argument to the application-supplied function that is passed as the second argument to ftw() and nftw():
- Directory without read permission.
- Directory with subdirectories visited.
- Unknown type; stat() failed.
- Symbolic link.
- Symbolic link that names a nonexistent file.
The <ftw.h> header shall define macros for use as values of the fourth argument to nftw():
- Physical walk, does not follow symbolic links. Otherwise, nftw() follows links but does not walk down any path that crosses itself.
- The walk does not cross a mount point.
- All subdirectories are visited before the directory itself.
- The walk changes to each directory before reading it.
The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.int ftw(const char *, int (*)(const char *, const struct stat *, int), int); int nftw(const char *, int (*)(const char *, const struct stat *, int, struct FTW*), int, int);
The <ftw.h> header shall define the stat structure and the symbolic names for st_mode and the file type test macros as described in <sys/stat.h>.
Inclusion of the <ftw.h> header may also make visible all symbols from <sys/stat.h>.
<sys/stat.h>, the System Interfaces volume of IEEE Std 1003.1-2001, ftw(), nftw()
First released in Issue 1. Derived from Issue 1 of the SVID.
A description of FTW_DP is added.