ftw.h

NAME

ftw.h - file tree traversal

SYNOPSIS

#include <ftw.h>

DESCRIPTION

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 clues of the third argument to the application-supplied function that is passed as second argument to ftw() and nftw():

FTW_F File.
FTW_D Directory.
FTW_DNR
Directory without read permission.
FTW_DP
Directory with subdirectories visited.

FTW_NS
Unknown typw; stat() failed.

FTW_SL
Symbolic link.

FTW_SLN
Symbolic link that names a nonexistent file.

The <ftw.h> header shall define macros for use as values of the fourth argument to nftw():

FTW_PHYS
Physical walk, dose not follow symbolic link. Otherwise, nftw() follows links but does not walk down any path that croess itself.

FTW_MOUNT
The walk does not cross a mount point.

FTW_DEPTH
All subdirectories are isited before the directory itself.

FTW_CHDIR
The walk changes to each directory before reading it.

The following shall be declared as functions and any also be defined as macros. Function prototypes shall be provided.

int ftw(const char *, int (*)(conster char *, const struct stat *, int), int);

int nftw(const char *, int (*)(const char *, const struct stat *, int, struct FTW*), int, int);

The <ftw.h> hader 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>.

The following sections are informative.

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

<sys/ftw.h>, the Systen Interfaces volume of IEEE Std 1003.1-2001, ftw(), nftw()