vxfs_ap_enforce_ckpt (3)


vxfs_ap_enforce_ckpt - enforce the allocation policy for a specific Storage Checkpoint 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_enforce_ckpt(int fd, char *ckptname, char *datapol, char *metapol uint64_t flags);




The vxfs_ap_enforce_ckpt() function enforces an allocation policy for the specified Storage Checkpoint of a file system specified by fd. The value of fd can be the file descriptor of any file that belongs to the file system. The Storage Checkpoint does not need to be mounted for this operation. This operation iterates over each inode in the Storage Checkpoint and enforces each Storage Checkpoint’s assigned allocation policy.

The datapol and metapol arguments are currently unused.

Possible values for flags are:

  Additional data and metadata may be moved to improve the allocation properties of the file with respect to the policy.


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


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


EINVAL The policy name contains invalid characters.
EIO An I/O error occurred during the operation.
ENOENT One or more of the specified policies does not exist.
ENOSPC There was not enough space to complete the operation.
ENOLIC There is no license installed to allow this 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.


vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3), vxfs_ap_define(3), vxfs_ap_define2(3), vxfs_ap_remove(3), vxfs_ap_enforce_ckptchain(3), vxfs_ap_enforce_file(3), vxfs_ap_enforce_file2(3), vxfs_ap_enumerate(3), vxfs_ap_query(3), vxfs_ap_query2(3), vxfs_ap_query_ckpt(3), vxfs_ap_query_file(3), vxfs_ap_query_fs(3), vxfs_vol_add(3), vxfs_vol_deencapsulate(3), vxfs_vol_encapsulate(3), vxfs_vol_enumerate(3), vxfs_vol_remove(3), vxfs_vol_resize(3), vxfs_vol_stat(3)

VxFS 5.1 SP1 vxfs_ap_enforce_ckpt (3)