NAME


ftw.h - file tree traversal


SYNOPSIS


#include


DESCRIPTION


The header shall define the FTW structure that includes at least the following members:


    int base

    int level


The 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 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 hader shall define the stat structure and the symbolic names for st_mode and the file type test macros as described in


Inclusion of the header may also make visible all symbols from .


The following sections are informative.


APPLICATION USAGE


None.


RATIONALE


None.


FUTURE DIRECTIONS


None.


SEE ALSO


, the Systen Interfaces volume of IEEE Std 1003.1-2001, ftw(), nftw()