gpfsListXAttr_t structure

Lists extended attributes.

Library

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

typedef struct {
  int structLen;
  int structType;
  int bufferLen;
  int errReasonCode;
  char buffer[0];
} gpfsListXAttr_t;

The gpfsListXAttr_t structure is used to list extended attributes.

structLen: Length of the gpfsListXAttr_t structure.
structType: Structure identifier GPFS_FCNTL_LIST_XATTR .
bufferLen: Input: Length of the buffer. Output: Length of the returned list of names.
The actual length of the buffer required depends on the number of attributes set and the length of each attribute name. If the buffer provided is too small for all of the returned names, the errReasonCode will be set to GPFS_FCNTL_ERR_BUFFER_TOO_SMALL, and bufferLen will be set to the minimum size buffer required to list all attributes. An initial buffer length of 0 may be used to query the attributes and determine the correct buffer size for this file.
errReasonCode: Reason code.
buffer: Buffer for the returned list of names. Each attribute name is prefixed with a one-byte name length. The attribute name may contain embedded null bytes. The attribute name may be null-terminated in which case the name length includes this null byte. The next attribute name follows immediately in the buffer (and is prefixed with its own length). Following the last name, a '\0' is appended to terminate the list. The returned bufferLen includes the final '\0'.

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

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