Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

nftw(3) OSS Library Calls Reference Manual
NAME
nftw - Traverses a file tree
LIBRARY
G-series native OSS processes: /G/system/sysnn/zossesrl
H-series OSS processes: /G/system/zdllnnn/zossedll
SYNOPSIS
#include <ftw.h>
int nftw(
const char *path,
int(*function)
(const char *object,
const struct stat *ptr,
int flag,
struct FTW *sftw),
int depth,
int flags);
PARAMETERS
path Points to the directory hierarchy to be searched.
function Points to the function to be invoked for each file in the directory hierarchy.
object Points to the name of the next file in the directory hierarchy specified in the path
parameter. This name must be a null-terminated string.
ptr Points to a stat structure, as defined in the sys/stat.h header file. The stat struc-
ture contains information about the file specified in the object parameter.
flag Specifies the type of file. See DESCRIPTION.
depth Indicates the maximum number of directory streams, file descriptors, or both
available for use by the nftw() function while traversing the tree. This parame-
ter is ignored in the OSS implementation.
flags Specifies optional flags that modify the operation of the nftw() function. The
following flags can be logically ORed to create the value for this parameter:
FTW_CHDIR Changes to each directory before reading its contents.
FTW_DEPTH Traverses all subdirectories before the directory itself.
FTW_MOUNT
Does not cross mount points during traversal.
FTW_PHYS Physically traverses the file tree, but does not follow symbolic
links. If this flag is not specified, nftw() does follow symbolic
links but does not go down any path that crosses itself.
sftw Points to an FTW structure. This structure contains the following fields of type
int:
base Contains the offset of the object filename in the pathname
passed in the path parameter.
level Contains the depth relative to the root of the search. The level
of the root of the search is 0 (zero).
5−4 Hewlett-Packard Company 527187-007