vxfs_ap_assign_ckptdef (3)


vxfs_ap_assign_ckptdef - assign a default allocation policy for new Storage Checkpoints of a VxFS file system


For 32-bit applications:

cc -I /opt/VRTS/include -L /opt/VRTS/lib

-l vxfsutil -ldl

For 64-bit applications:

cc -I /opt/VRTS/include -L /opt/VRTS/lib/64

-l vxfsutil -ldld

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

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




The allocation policies specified with the vxfs_ap_assign_ckptdef() function are assigned to subsequently created Storage Checkpoints that do not name specific policies as part of their creation. Assigning the default Storage Checkpoint policy only affects new Storage Checkpoints, not any existing Storage Checkpoints.

The fd argument can reference any file within the file system. To clear a policy assignment, specify a NULL pointer for the policy fields to be cleared (either datapol or metapol).

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.


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


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


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.
EROFS The specified file system is mounted read-only.


vxfs_ap_assign_ckpt(3), vxfs_ap_assign_ckptchain(3), vxfs_ap_assign_fs(3), vxfs_ap_query_ckptdef(3)

VxFS 5.1 SP1 vxfs_ap_assign_ckptdef (3)