GPFS: Administration and Programming Reference - IRA Home

gpfs_fputattrs() Subroutine
Name
gpfs_fputattrs() – Sets all the extended file attributes for a file.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_fputattrs(int fileDesc, int flags, void *bufferP)
Description
The gpfs_fputattrs() subroutine, together with gpfs_fgetattrs() is intended for use by a backup program
to save (gpfs_fgetattrs()) and restore (gpfs_fputattrs()) extended ACLs defined for the file.
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 set.
flags RESERVED This value must be set to 0.
bufferP A pointer to the buffer containing the extended attributes for the file.
If you specify a value of NULL, all extended ACLs for the file are deleted.
Exit status
If the gpfs_fputattrs() subroutine is successful, it returns a value of 0.
If the gpfs_fputattrs() 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
EINVAL The buffer pointed to by bufferP does not contain valid attribute data.
ENOSYS The gpfs_fputattrs() subroutine is not supported under the current file system format.
Examples
To copy extended file attributes from file f1 to file f2:
char buf[4096];
int f1, f2, attrSize, rc;
rc = gpfs_fgetattrs(f1, 0, buf sizeof(buf), &attrSize);
if (rc != 0)
... // error handling
if (attrSize != 0)
288 GPFS: Administration and Programming Reference