Open System Services Library Calls Reference Manual (G06.27+, H06.04+)

ftw(3) OSS Library Calls Reference Manual
[EACCES] in errno.
The ftw() function finishes processing a directory before processing any of its files or subdirec-
tories.
The ftw() function continues the search until either the directory hierarchy specified by the path
parameter is completely searched, an invocation of the function specified by the function parame-
ter returns a nonzero value, or an error is detected within ftw( ), such as an I/O error.
Because ftw( ) is recursive, it can terminate with a memory fault because of stack overflow when
the function is called for very deep tree structures.
The ftw() function uses the malloc() function to allocate dynamic storage during its operation. If
ftw() is terminated prior to its completion, such as by the longjmp( ) function being executed by
the function specified by the function parameter, ftw( ) cannot free that storage. The storage
remains allocated.
The ftw() function traverses symbolic links encountered in the resolution of path, including the
final component. Symbolic links encountered while traversing the directory tree rooted at path
are not traversed.
Use on Guardian Objects
All Guardian files (that is, files in /G) that are visible to the opendir() function can be traversed.
This includes temporary and structured files.
Safeguard subsystem security controls on Guardian objects do not affect the outcome of a call to
the ftw( ) function.
Use From the Guardian Environment
The ftw() function is one of a set of functions that have the following effects when the first of
them is called from the Guardian environment:
• Two Guardian file system file numbers (not necessarily the next two available) are allo-
cated for the root directory and the current working directory. These file numbers cannot
be closed by calling the Guardian FILE_CLOSE_ procedure.
• The current working directory is assigned from the VOLUME attribute of the Guardian
environment =_DEFAULTS DEFINE.
• The use of static memory by the process increases slightly.
These effects occur only when the first of the set of functions is called. The effects are not cumu-
lative.
NOTES
The ftw() function is reentrant, and care should be taken to ensure that the function supplied as
the function parameter is also reentrant.
If you use this function on the local / (slash) root directory, the action includes the /G and /E
directories. Actions appropriate for local OSS files under / often are not appropriate for local
Guardian files or for any files on other HP NonStop server nodes.
The UTILSGE environment variable that governs shell utility behavior can be used to test or
recommend whether use should include Guardian files or files on remote HP NonStop server
nodes. Note that UTILSGE settings are only advisory for functions; changing the variable value
does not affect function behavior. Refer to the environ(5) reference page either online or in the
Open System Services System Calls Reference Manual for more information about UTILSGE.
2−112 Hewlett-Packard Company 527187-004