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

System Functions (f - i) fstat64(2)
For J06.09 and later J-series RVUs and H06.20 and later H-series RVUs, access by the OSS Net-
work File System (NFS) to OSS objects that have OSS ACLs that contain optional ACL entries
can be allowed, depending upon the NFSPERMMAP attribute value for the fileset that contains
the object. For more information about NFS and ACLs, see the acl(5) reference page.
To use the fstat64( ) functionality in a threaded application that uses the Standard POSIX
Threads library, see spt_fstat64tz(2).
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks to make the function thread-aware in a multi-threaded application:
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit OSS applications.
To use this function in a 32-bit threaded application on systems running H06.24 or later RVUs or
J06.13 or later RVUs, perform the same tasks (described above) used to make the function
thread-aware in a multi-threaded application on systems running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit threaded application on systems running H06.24 or later RVUs or
J06.13 or later RVUs, you must perform all of the following tasks to make the function thread-
aware in a multi-threaded application:
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Compile the application using the -Wlp64 compiler command option.
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll).
For detailed information about writing multi-threaded and 64-bit applications for the Open Sys-
tem Services environment, see the Open System Services Programmer’s Guide.
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 fstat64( ) 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.
527186-023 Hewlett-Packard Company 3−43