gpfs_opaque_acl_t structure

Contains buffer mapping for the gpfs_getacl() and gpfs_putacl() subroutines.

Library

GPFS Library (libgpfs.a for AIX®, libgpfs.so for Linux®)

Structure

typedef struct
{
  int             acl_buffer_len;
  unsigned short  acl_version;
  unsigned char   acl_type; 
  char            acl_var_data[1];
} gpfs_opaque_acl_t;

Description

The gpfs_opaque_acl_t structure contains size, version, and ACL type information for the gpfs_getacl() and gpfs_putacl() subroutines.

Members

acl_buffer_len: On input, this field must be set to the total length, in bytes, of the data structure being passed to GPFS. On output, this field contains the actual size of the requested information. If the initial size of the buffer is not large enough to contain all of the information, the gpfs_getacl() invocation must be repeated with a larger buffer.
acl_version: This field contains the current version of the GPFS internal representation of the ACL. On input to the gpfs_getacl() subroutine, set this field to zero.
acl_type: On input to the gpfs_getacl() subroutine, set this field to either GPFS_ACL_TYPE_ACCESS or GPFS_ACL_TYPE_DEFAULT, depending on which ACL is requested. These constants are defined in the gpfs.h header file.
acl_var_data: This field signifies the beginning of the remainder of the ACL information.

Location

/usr/lpp/mmfs/lib/libgpfs.a for AIX

/usr/lpp/mmfs/lib/libgpfs.so for Linux