test veritas logo


vxfs_ap_enforce_range(3)

NAME

vxfs_ap_enforce_range - reallocate blocks in a file within a specified range to match allocation policies

SYNOPSIS

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/lib64

-l vxfsutil -ldld

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_enforce_range(int fd, uint64_t offset, uint64_t length, char *datapol, uint32_t flags);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_enforce_range() reallocates the blocks in the file specified by fd within a range, as specified by offset and length, so that those allocations match the specified policy.

To use this function, specify -l vxfsutil while linking. Specify the /opt/VRTSvxfs/lib directory for 32-bit executables, or the /opt/VRTSvxfs/lib64 directory for 64-bit executables.

NOTES

This API supports disk layout Version 8 and later.

FLAGS

FSAP_ENF_STRICT Strictly enforces the FSAP_ORDER_ASGIVEN and FSAP_ORDER_BALANCE allocation orders.

RETURN VALUES

vxfs_ap_enforce_range() returns zero on success, and non-zero on failure.

ERRORS

EFAULT One or more of the specified pointer arguments points to an illegal address.
EIO An I/O error occurred during the operation.
ENOENT One or more of the named policies does not exist.
ENOSPC There was not enough space in the appropriate volumes to hold all the blocks of this file.
ENOSYS There is no license installed to allow this operation.
ENOTSUP This operation is not supported by the disk layout version of the specified file system. Use the vxupgrade command to enable this operation.
See the vxupgrade(1M) manual page.
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_file(3), vxfs_ap_enumerate(3), vxfs_ap_enumerate2(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_range(3)