Symantec logo

vxfs_ap_assign_file

NAME

vxfs_ap_assign_file - assign an allocation policy for file data and metadata

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/lib/sparcv9
-l vxfsutil -ldl

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_assign_file(int fd, char *datapol, char *metapol, uint32_t flags);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_assign_file() assigns the given allocation policies for data and metadata to the file specified by fd. The datapol field specifies an existing data policy. The metapol field specifies an existing metadata policy. To clear a policy assignment, specify a NULL pointer for the policy field to be cleared (either datapol or metapol).

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

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 API supports file system versions 6.0 and above.

FLAGS

FSAP_INHERIT

Files created in the directory specified by fd inherit the directory's policy assignments.

RETURN VALUES

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

ERRORS

EFAULT

One or more of the specified pointer arguments points to an illegal address.

EFBIG

The calling function issued a request with a file offset off past the EOF mark.

EINVAL

The specified flags are invalid.

EIO

An I/O error occurred during the operation.

ENOENT

One or more of the specified policies does not exist.

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 vxupgrade(1m) to enable this operation.

ENXIO

An I/O error occurred during the 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_fs(3), vxfs_ap_define(3), vxfs_ap_remove(3), vxfs_ap_enforce_file(3), vxfs_ap_enumerate(3), vxfs_ap_query(3), vxfs_ap_query_ckpt(3), vxfs_ap_query_file(3), vxfs_ap_query_fs(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)