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

ftw(3) OSS Library Calls Reference Manual

• If the function speciﬁed by the function parameter returns a value other than 0 (zero),

ftw() terminates its search and returns the value that was returned by function.

• If ftw() detects an error other than that for FTW_DNR or FTW_NS (that is, other than

[EACCES]), the value -1 is returned and errno is set to indicate the error.

ERRORS

If any of these conditions occurs, the ftw( ) function sets errno to the corresponding value:

[EACCES] One of these statemetns is true:

• Search permission is denied for any component of the path parameter.

• Read permission is denied for the path parameter.

• The function speciﬁed by the function parameter returns -1 and does not

reset the value of errno.

[EFSBAD] The program attempted an operation involving a ﬁleset with a corrupted ﬁleset

catalog.

[ELOOP] Too many symbolic links were encountered in translating path.

[ENAMETOOLONG]

One of these names is too long:

• The pathname pointed to by the path parameter

• A component of the pathname pointed to by the path parameter

• The intermediate result of pathname resolution when a symbolic link is

part of the path parameter

You can call the pathconf( ) function to obtain the applicable limits.

[ENOENT] One of the following conditions exists:

• The path parameter points to the name of a ﬁle that does not exist.

• The path parameter points to an empty string.

• The path parameter speciﬁes a ﬁle on a remote HP NonStop server node,

but communication with the remote node has been lost.

[ENOMEM] The system has insufﬁcient resources.

[ENOROOT] One of the following conditions exists:

• The root ﬁleset of the local node (ﬁleset 0) is not in the STARTED state.

• The current root ﬁleset for the speciﬁed ﬁle is unavailable. The OSS

name server for the ﬁleset might have failed.

• The speciﬁed ﬁle is on a remote HP NonStop server node and communi-

cation with the remote name server has been lost.

2−146 Hewlett-Packard Company 527187-007