GPFS: Administration and Programming Reference - IRA Home

gpfs_stat() Subroutine
Name
gpfs_stat() – Returns exact file status for a GPFS file.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_stat(char *pathName, struct stat64 *Buffer)
Description
The gpfs_stat() subroutine is used to obtain exact information about the file named by the pathName
parameter. This subroutine is provided as an alternative to the stat() subroutine, which may not provide
exact mtime and atime values. See “Exceptions to Open Group technical standards” on page 371.
read, write, or execute permission for the named file is not required, but all directories listed in the path
leading to the file must be searchable. The file information is written to the area specified by the Buffer
parameter.
Notes:
1. Compile any program that uses this subroutine with the -lgpfs flag from the following library:
v libgpfs.a for AIX
v libgpfs.so for Linux
Parameters
pathName The path identifying the file for which exact status information is requested.
Buffer A pointer to the stat64 structure in which the information is returned. The stat64 structure
is described in the sys/stat.h file.
Exit status
If the gpfs_stat() subroutine is successful, it returns a value of 0.
If the gpfs_stat() subroutine is unsuccessful, it returns a value of -1 and sets the global error variable
errno to indicate the nature of the error.
Exceptions
None.
Error status
EBADF The path name is not valid.
EINVAL The path name does not refer to a GPFS file or a regular file.
ENOSYS The gpfs_stat() subroutine is not supported under the current file system format.
Location
/usr/lpp/mmfs/lib/libgpfs.a for AIX, /usr/lpp/mmfs/lib/libgpfs.so for Linux
Chapter 9. GPFS programming interfaces 343