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

spt_fstat64z(2) OSS System Calls Reference Manual
For C++ applications, an alias to map fstat() to spt_fstat64z( ) is available when you use the
#define SPT_THREAD_AWARE_PRAGMA_XNONBLOCK and the #define
_FILE_OFFSET_BITS 64 preprocessor directives before including spthread.h or when you
use equivalent compiler command options to compile the application.
For C applications, a macro to map fstat64( ) to spt_fstat64z() is available when you use the
#define SPT_THREAD_AWARE_XNONBLOCK and the #define
_LARGEFILE64_SOURCE 1 preprocessor directives before including spthread.h or when
you use equivalent compiler command options to compile the application.
For C++ applications, an alias to map fstat64() to spt_fstat64z() is available when you use the
#define SPT_THREAD_AWARE_PRAGMA_XNONBLOCK and the #define
_LARGEFILE64_SOURCE 1 preprocessor directives before including spthread.h or when
you use equivalent compiler command options to compile the application.
A direct application call to spt_fstatz() is automatically mapped to spt_fstat64z() when you use
the #define _FILE_OFFSET_BITS 64 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_fstat64z( ) 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.
7−234 Hewlett-Packard Company 527186-023