gpfsRestripeData_t structure

Restripes the data blocks of a file.

Library

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

Structure

typedef struct {
  int structLen;
  int structType;
  int options;
  int errReason;
  int errValue1;
  int errValue2;
  int reserved1;
  int reserved2;
} gpfsRestripeData_t;

Description

The gpfsRestripeData_t structure is used to restripe a file's data blocks to updates its replication and migrate its data. The data movement is always done immediately.

Members

structLen

Length of the gpfsRestripeData_t structure.

structType

Structure identifier GPFS_FCNTL_RESTRIPE_DATA.

options

Options for restripe command. See the mmrestripefile command for complete definitions.

GPFS_FCNTL_RESTRIPE_M: Migrate critical data off of suspended disks.
GPFS_FCNTL_RESTRIPE_R: Replicate data against subsequent failure.
GPFS_FCNTL_RESTRIPE_P: Place file data in assigned storage pool.
GPFS_FCNTL_RESTRIPE_B: Rebalance file data.

errReason

Reason code describing the failure. Possible codes are defined in Error status.

errValue1

Returned value depending upon errReason.

errValue2

Returned value depending upon errReason.

reserved1

Unused, but should be set to 0.

reserved2

Unused, but should be set to 0.

Error status

These values are returned in the errReason field:

GPFS_FCNTL_ERR_NO_REPLICA_GROUP: Not enough replicas could be created because the desired degree of replication is larger than the number of failure groups.
GPFS_FCNTL_ERR_NO_REPLICA_SPACE: Not enough replicas could be created because there was not enough space left in one of the failure groups.
GPFS_FCNTL_ERR_NO_BALANCE_SPACE: There was not enough space left on one of the disks to properly balance the file according to the current stripe method.
GPFS_FCNTL_ERR_NO_BALANCE_AVAILABLE: The file could not be properly balanced because one or more disks are unavailable.
GPFS_FCNTL_ERR_ADDR_BROKEN: All replicas were on disks that have since been deleted from the stripe group.
GPFS_FCNTL_ERR_NO_IMMUTABLE_DIR: No immutable attribute can be set on directories.
GPFS_FCNTL_ERR_NO_IMMUTABLE_SYSFILE: No immutable attribute can be set on system files.
GPFS_FCNTL_ERR_IMMUTABLE_FLAG: Immutable and indefinite retention flag is wrong.
GPFS_FCNTL_ERR_IMMUTABLE_PERM: Immutable and indefinite retention flag is wrong.
GPFS_FCNTL_ERR_APPENDONLY_CONFLICT: The appendOnly flag should be set separately.
GPFS_FCNTL_ERR_NOIMMUTABLE_ONSNAP: Cannot set immutable or appendOnly on snapshots.
GPFS_FCNTL_ERR_FILE_HAS_XATTRS: An attempt to change maxDataReplicas or maxMetadataReplicas was made on a file that has extended attributes.
GPFS_FCNTL_ERR_NOT_GPFS_FILE: This file is not part of a GPFS file system.

Location

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

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