GPFS: Administration and Programming Reference - IRA Home

gpfs_igetattrs() Subroutine
Name
gpfs_igetattrs() - Retrieve all extended file attributes in opaque format.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_igetattrs(gpfs_ifile_t *ifile,
void *buffer,
int bufferSize,
int *attrSize);
Description
The gpfs_igetattrs() subroutine retrieves all extended file attributes in opaque format. This subroutine is
intended for use by a backup program to save all extended file attributes (ACLs, DMAPI attributes, and so
forth) in one invocation. If the file does not have any extended attributes, the subroutine sets attrSize to
zero.
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
ifile Pointer to gpfs_ifile_t from gpfs_iopen().
buffer Pointer to buffer for returned attributes.
bufferSize Size of the buffer.
attrSize Pointer to returned size of attributes.
Exit status
If the gpfs_igetattrs() subroutine is successful, it returns a value of 0.
If the gpfs_igetattrs() 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
ENOSYS The gpfs_igetattrs() subroutine is not available.
EPERM The caller does not have superuser privileges.
ERANGE The buffer is too small to return all attributes. Field *attrSizeP will be set to the size
necessary.
ESTALE Cached file system information was not valid.
Chapter 9. GPFS programming interfaces 311