ftw.h - file tree traversal
[XSI] #include <ftw.h>
The <ftw.h> header shall define the FTW structure, which shall include at least the following members:int base int level
The <ftw.h> header shall define the following symbolic constants for use as values of the third argument to the application-supplied function that is passed as the second argument to ftw() and nftw():
- Non-directory file.
- 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 the following symbolic constants 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.[OB] 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>.
XSH ftw, nftw
First released in Issue 1. Derived from Issue 1 of the SVID.
A description of FTW_DP is added.
The ftw() function is marked obsolescent.
This reference page is clarified with respect to macros and symbolic constants.
POSIX.1-2008, Technical Corrigendum 1, XBD/TC1-2008/0048  is applied.
return to top of page