Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)
spt_fstatz(2) OSS System Calls Reference Manual
For C++ applications, an alias to map fstat() to spt_fstatz() is available when you use the
#define SPT_THREAD_AWARE_PRAGMA_XNONBLOCK preprocessor directive before
including spthread.h or when you use an equivalent compiler command option to compile the
application.
To use this function in a threaded application that uses the Standard POSIX Threads library on
systems running J06.10 or later RVUs or H06.21 or later RVUs, you must perform all of the fol-
lowing tasks:
• Include the spthread.h header file in the application.
• Compile the application using the _SPT_MODEL_ feature test macro or equivalent
compiler command option in addition to any other feature test macros in use.
• Link the application to the zsptdll library (/G/system/zdllnnn/zsptdll).
RETURN VALUES
Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned,
and errno is set to indicate the error.
ERRORS
If any of these conditions occurs, the spt_fstatz() function sets errno to the corresponding value:
[EBADF] The filedes parameter is not a valid file descriptor.
[EFAULT] The buffer parameter points to a location outside of the allocated address space
of the process.
[EFSBAD] The program attempted an operation involving a fileset with a corrupted fileset
catalog.
[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.
[EISGUARDIAN]
The value used for the filedes parameter is appropriate only in the Guardian
environment.
[ENETDOWN]
The filedes parameter specifies a file on a remote HP NonStop node, but com-
munication with the remote node has been lost.
[ENOROOT] The program attempted an operation while the root fileset was unavailable.
[ENXIO] An invalid device or address was specified during an input or output operation
on a special file. One of these events occurred:
• A device was specified that does not exist, or a request was made beyond
the limits of the device.
• The fileset containing the requestor’s current working directory or root
directory is not mounted. This error can occur after failure and restart of
an OSS name server process until the fileset has been repaired and
remounted.
7−244 Hewlett-Packard Company 527186-023