test veritas logo


vxfs_ap_enforce_ckpt(3)

NAME

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

AVAILABILITY

VRTSvxfs

DESCRIPTION

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:

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

NOTES

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

RETURN VALUES

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

ERRORS

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.

SEE ALSO

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 7.4.1 vxfs_ap_enforce_ckpt(3)