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

pathconf(3) OSS Library Calls Reference Manual
RETURN VALUES
Upon successful completion, the pathconf() function returns the specified parameter. Otherwise,
the value -1 is returned and errno is set to indicate the error. The value -1 is returned, with errno
unchanged, if the variable corresponding to name has no limit for the path or file descriptor.
The pathconf( ) function returns the value -1 and sets errno if one or more of the following are
true:
• Your system needs to use the path parameter to determine the value of name, but your
system does not allow name to be associated with the file specified by path.
• The process does not have appropriate privilege to access the file specified by path.
• path does not exist.
ERRORS
If any of the following conditions occurs, the pathconf( ) function sets errno to the correspond-
ing value:
[EACCES] Search permission is denied for a component of the pathname prefix.
[EFAULT] The path parameter is an invalid address.
[EFSBAD] The program attempted an operation involving a fileset with a corrupted fileset
catalog.
[EINVAL] The name parameter specifies an unknown or inapplicable characteristic.
[EIO] An input or output error occurred. The device holding the file might be in the
down state, or both processors that provide access to the device might have
failed.
[ELOOP] Too many symbolic links were encountered in translating a pathname.
[ENAMETOOLONG]
One of the following 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
Refer to the table under DESCRIPTION earlier in this reference page for infor-
mation about valid lengths.
[ENOENT] One of the following conditions exists:
• The named file does not exist.
• The path parameter points to an empty string.
• The path parameter specifies a file on a remote HP NonStop server node
but communication with the remote node has been lost.
5−24 Hewlett-Packard Company 527187-004