Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

ftw64(3) OSS Library Calls Reference Manual

You can use the UTILSGE environment variable that governs shell utility to test or recommend

whether use should include Guardian ﬁles or ﬁles on remote HP NonStop server nodes.

UTILSGE settings are only advisory for functions; changing the variable value does not affect

function behavior. For more information about UTILSGE, see the environ(5) reference page.

RETURN VALUES

The ftw64( ) function continues processing until one of the following conditions occurs; it then

returns the appropriate value, as follows:

• If the traversal of the directory hierarchy is complete, the ftw64( ) function returns the

value 0 (zero).

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

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

• If ftw64( ) 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 ftw64( ) function sets errno to the corresponding value:

[EACCES] One of these statements 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.

2−206 Hewlett-Packard Company 527187-017