Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_AP_QUERY_FILE (3)

Library Functions

Table of contents


NAME

vxfs_ap_query_file - return information about file allocation policies

SYNOPSIS

cc -I /opt/VRTS/include -L /opt/VRTS/lib
-l vxfsutil -ldl

#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 NUL-terminated. If no policy is assigned, the string "NONE" is returned.

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.
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
An I/O error occurred during the operation.

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_ckpt(3), .. vxfs_ap_enforce_file(3), vxfs_ap_enforce_fs(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)

Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.