test veritas logo


vxfs_ap_assign_ckptchain(3)

NAME

vxfs_ap_assign_ckptchain - assign an allocation policy for all of the Storage Checkpoints of a VxFS file system

SYNOPSIS

cc -I /opt/VRTS/include -L /opt/VRTS/lib
-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_assign_ckptchain(int fd, char *datapol, char *metapol);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_assign_ckptchain() assigns the given allocation policies for data and metadata to all of the Storage Checkpoints of the file system specified by fd. The Storage Checkpoints do not need to be mounted for this operation. This operation iterates over the chain of Storage Checkpoints while assigning a policy on each. The entire operation is not atomic.

The datapol argument is the name of the data policy that can be created with fsapadm(1M) or through the vxfs_ap_define() API. The metapol argument is the name of the metadata policy that can be created with fsapadm(1M) or through the vxfs_ap_define() API. The file descriptor fd can refer to any file in the file system.

NOTES

Assigning or defining an allocation policy can fail because of a conflict with volume flags. The conflict detection attempts to detect all conflicts, but there is no guarantee that all conflicts will be detected.

This function is supported on Version 6 and later disk layouts.

RETURN VALUES

vxfs_ap_assign_ckptchain() returns zero on success, non-zero on failure.

ERRORS

EAGAIN The metapolicy contains one or more data-only volumes.
EINVAL The policy name contains invalid characters.
EIO An I/O error occurred during the operation.
ENOLIC There is no license installed to allow this operation.
ENOENT One or more of the specified policies does not exist.
ENOSPC The file system does not have enough space to complete operation.
EPERM The effective user ID of the calling process does not have appropriate privileges to perform this operation.
EROFS The specified file system is mounted read-only.

SEE ALSO

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3)


VxFS 8.0 vxfs_ap_assign_ckptchain(3)