Symantec logo

vxfs_ap_query_file

NAME

vxfs_ap_query_file - return information about file 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/lib/sparcv9
-l vxfsutil -ldl

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

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

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_query_file() retrieves the allocation policies assigned to the file specified by fd. The datapol and metapol arguments must point to buffers of (FSAP_NAMESZ + 1) bytes, which are filled in with the name of the policy (if any) and NULL-terminated. If no policy is assigned, the string "NONE" is returned.

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

This API does not require root permission and can be run by any user. 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_query_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.

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

There is no such device or address.

SEE ALSO

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(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_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)