GPFS: Administration and Programming Reference - IRA Home

gpfs_putacl() Subroutine
Name
gpfs_putacl() – Restores the access control information for a GPFS file.
Library
GPFS Library (libgpfs.a for AIX, libgpfs.so for Linux)
Synopsis
#include
int gpfs_putacl(char *pathname, int flags, void *aclP)
Description
The gpfs_putacl() subroutine together with the gpfs_getacl() subroutine is intended for use by a backup
program to save (gpfs_getacl()) and restore (gpfs_putacl()) the ACL information for the file.
Notes:
1. The use of gpfs_fgetattrs() and gpfs_fputattrs() is preferred.
2. You must have write access to the file.
3. 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 Path name of the file for which the ACLs is to be set.
flags Consists of one of these values:
0 Indicates that the aclP parameter is to be mapped with the
gpfs_opaque_acl_t struct.
The gpfs_opaque_acl_t struct should be used by backup and restore
programs.
GPFS_PUTACL_STRUCT
Indicates that the aclP parameter is to be mapped with the gpfs_acl_t
struct.
The gpfs_acl_t struct is provided for applications that need to change the
ACL.
aclP Pointer to a buffer mapped by the structure gpfs_opaque_acl_t or gpfs_acl_t, depending
on the value of flags.
This is where the ACL data is stored, and should be the result of a previous invocation of
gpfs_getacl().
Exit status
If the gpfs_putacl() subroutine is successful, it returns a value of 0.
If the gpfs_putacl() subroutine is unsuccessful, it returns a value of -1 and sets the global error variable
errno to indicate the nature of the error.
Chapter 9. GPFS programming interfaces 335