GPFS: Administration and Programming Reference - IRA Home

gpfs_fgetattrs() Subroutine
Name
gpfs_fgetattrs() – Retrieves all extended file attributes in opaque format.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_fgetattrs(int fileDesc, int flags, void *bufferP,
int bufferSize, int *attrSizeP)
Description
The gpfs_fgetattrs() subroutine, together with gpfs_fputattrs() is intended for use by a backup program
to save (gpfs_fgetattrs()) and restore (gpfs_fputattrs()) extended ACLs defined for the file. If the file has
no extended ACLs, the gpfs_fgetattrs() subroutine returns a value of 0, but sets attrSizeP to zero and
leaves the content of the buffer unchanged.
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
fileDesc The file descriptor identifying the file whose extended attributes are being retrieved.
flags RESERVED. This value must be set to 0.
bufferP Pointer to a buffer to store the extended attribute information.
bufferSize The size of the buffer that was passed in.
attrSizeP If successful, returns the actual size of the attribute information that was stored in the
buffer. If the bufferSize was too small, returns the minimum buffer size.
Exit status
If the gpfs_fgetattrs() subroutine is successful, it returns a value of 0.
If the gpfs_fgetattrs() 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
ENOSPC bufferSize is too small to return all of the attributes. On return, *attrSizeP is set to the
required size.
ENOSYS The gpfs_fgetattrs() 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 287